Update Notion pages after a release
A release can change your product while the Notion page about it stays the same. This guide takes one Notion page from the release to a reviewed fix.
Before you start
- The repo is connected and Notion is added on the Pages tab, with the page shared. See Connect Notion.
- An owner can choose what your pages follow.
- Help center is on Review first, so you see the first fix before it is applied.
1. Follow what shipped and watch the page
- On the Notion card on the Pages tab, an owner sets Help articles follow to the repo.
- Select Browse, find the page and select Watch, then As Help center. The page follows the repo, so you do not map it by hand.
- On the Repos tab, set What counts as shipped to GitHub Releases if releases are what your customers get.
2. Check a release
Daily checks find new releases. To see a result today, open Check recent changes on Home and select Check the last release. A release that makes nothing wrong drafts nothing.
In this made-up example, a release raises an API limit from 60 to 120 requests per minute.
Before: You can make up to 60 requests per minute.
After: You can make up to 120 requests per minute.
3. Review the fix
- Open the fix in the Queue. Read the change it links to.
- Compare the page text with the Proposed change. Check that 120 applies to the customers this page is for.
- If the change is about another plan or endpoint, select Dismiss.
4. Update it and check Notion
- Select Update in Notion. Amendary edits the block in place, or adds a comment when the edit cannot be placed safely.
- Open the page in Notion and read it.
- For 30 days, Undo in the Queue writes the old text back, unless the block changed since. See Review and undo.
Languages
Each Notion page is checked on its own. A fix is not carried into translated pages. For fixes in every language, use GitHub, Zendesk or Intercom.
If no fix appears
- Check that the page is shared with Amendary, watched as Help center, and the card follows the repo.
- Check that a release exists. With GitHub Releases chosen and none published, nothing is checked.
- A page is missing? Open the … menu on the Notion card, select Add a page by link… and paste its link.
- More in Troubleshooting.
More
What Amendary reads and writes: Notion integration. The use case: Notion help centers.
The same guide for another destination:
Try Amendary with Notion
Connect Notion, choose the pages or articles to watch, and review proposed corrections with the change behind each one.
Free for 14 days with no card, and every edit waits for your review. Or free forever with your own Anthropic API key. Code is never touched.