Editing without git

Pages CMS (recommended)

Open app.pagescms.org, sign in with GitHub and pick the docs repo. The menu has three entries:

• Pages — .md files. Use this for almost everything.
• Pages (MDX) — .mdx files, for pages with components such as <Callout> or the cards on the home page.
• Folder settings — the meta.json in each folder: its title, page order, and whether it is a section or private.

Title, description and the private switch are form fields. The body is a plain Markdown editor on purpose: the visual editor rewrites Markdown and breaks MDX components, so it is switched off.

Saving commits straight to main, and the site redeploys on its own.

To make a new folder, create a page and type the folder into its path (for example cooking/index). Pages CMS has no separate “new folder” button.

GitHub (fallback)

On github.com, open the repo, browse to the file and press the pencil icon. On a phone this works in the browser or the GitHub app. Commit directly to main and the deploy starts the same way. Add file → Create new file with a path like cooking/pasta.md makes folders as it goes.

Rules of thumb

• Every page needs a title in its frontmatter (the block between the --- lines at the top).
• Prefer .md. Reach for .mdx only when you need a component.
• Check the page a few minutes after saving. If it did not change, the build failed; see How this site works.