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.
You can filter on criteria such as label, project, status, and more to curate your side panel view.
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.
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.
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.