Connect a Data Source

How to connect a Data Source in Makelog.

Overview

You can connect Data Sources such as Linear, GitHub, Jira, and Clubhouse to your Makelog account in order to view entries (recent issues, tickets, merged PRs) when writing your product updates.

This can be useful when crafting a product update that includes many granular customer-facing updates, such as minor features, improvements, and bug fixes.

Connect a Data Source

You can connect a Data Source by going to Settings > Data Sources.

Here, you'll have the option to connect with the following integrations:

Clubhouse - The intuitive and powerful project management platform.

GitHub - GitHub is a code hosting platform for version control and collaboration.

Jira - Plan, track, and manage your agile and software development projects in Jira.

Linear - Linear helps streamline software projects, sprints, tasks, and bug tracking.

Connect using your credentials and Makelog will begin to sync entries from your respective Data Source account. You will see these synced entries in the New Post view when you begin to write your updates.

How to Use Entries from a Data Source

Once entries populate your side panel on the Editor screen, you can easily use them as a reference for writing comprehensive product updates.

Select the date range you want to pull entries from. For example, if you're writing weekly product updates, you may want to select a week's worth of data.

Note that date range is the date when the entry was last updated in the Data Source, not when it was completed or created.

Filtering entries

You can filter on criteria such as label, project, status, and more to curate your side panel view.

Clubhouse
GitHub
Jira
Linear
Clubhouse

Filter

Definition

Epic ID

Label

Project Name

Type

Workflow

GitHub

Filter

Definition

Created By

Label

Merged By

Milestone Name

Repository Name

Type

Jira

Filter

Definition

Epic

Fix Version

Label

Project

Status

Type

Linear

Filter

Definition

Assignee

Cycle

Label

Priority

Project Name

Status

Team

Type

Dragging and dropping entries into your posts

You can drag individual entry cards into your post, where Makelog will automatically create a bullet that we populate with the entry title.

In the below example, you can see grayed out entries that have already been dragged into the Editor.

Troubleshooting

I've connected my [Clubhouse/GitHub/Jira/Linear] account and navigated to New Post, but I don't see any entries synced. Depending on how much data you're syncing, it may take a few minutes (but no more than 3-5) to sync your entries to Makelog.

If it's been that long, check that you have the appropriate permissions in [Clubhouse/GitHub/Jira/Linear]. Makelog only pulls in data for projects that your user account has access to. In some cases, an admin's account must be connected in order to import all relevant Data Source entries in Makelog.

If you've checked that you have the right permissions, it's been more than 5 minutes, and you're still not seeing anything, please contact us at [email protected].

It says there's a sync error. Double-check the API key you're using is correct. If it is, and you're still seeing a sync error, try clicking on the sync error message to force a new sync.

If you're still getting a sync error after confirming your API key and forcing a new sync, please contact us at [email protected].

I am trying to drag and drop entries into the Editor, but it's not working. Make sure that, as you're dragging the entry into the Editor, you see the placement cursor:

That's how Makelog knows where to put the bullet point that we'll create for the entry.

FAQs

What is an entry? An entry is any ticket, merged PR, issue, or task that you import from a Data Source into Makelog.

Each entry is represented by a card in the side panel to the left of the Makelog Editor. These cards can be dragged and dropped into the Makelog Editor. If you drag a card into the Makelog Editor, we will generate a bullet point with the title of the entry.

Will my tickets be updated in Makelog if I make changes to them in the original Data Source? Yes, Makelog refreshes syncs in the background every 10 minutes and looks for changes to the entries from a Data Source. If there's a change, we update the entry card.