Engineers write the posts on this blog, but they rarely press the publish button. That step belongs to whoever edits the text, and it does not require a terminal.
The editor’s workflow
- Open Pages CMS and pick Posts.
- Create a post or open an existing draft. Fill in the title, subtitle, publish date, author and topic.
- Paste the body. Markdown exported from Notion works as-is in the source view.
- Attach a hero image if there is one. A 1440 by 500 pixel image under 200 KB fits the post list; the post header crops a little from each side.
- Leave Draft on while the text is in review. Turn it off to publish, then save.
Saving creates a commit on the main branch. The site rebuilds and the post appears about two minutes later.
Drafts
A post with Draft on never reaches the live site, the RSS feed or the sitemap. It still renders locally for anyone running the site on their machine, which is how engineers review formatting before an editor takes over.
Fixing a mistake
Open the post, change the text, save. The same rebuild runs again. If the whole post needs to go, turn Draft back on and it disappears on the next build.