How to write a post for the Asks blog
The shape of a post: the frontmatter, sections, an FAQ, links to the rest of the site, and the checks a post passes before it goes out.
Preview: example, never published. Only a preview or pnpm dev shows it.
On this page4 sections
This file is the template. Its name starts with _, so it is never published. Copy it to a new file named after the slug, for example content/blog/get-feedback-on-my-app.mdx, and replace every part of it.
Open with two or three sentences that settle the question in the title. A reader who stops here should still leave with what they came for.
Say what the reader will get
Each section starts at ##. The title is the page's only first-level heading, so never use a single #.
Write in plain sentences. Name the thing, then say what it does. Keep paragraphs short: three or four sentences on a phone is already a screen.
A smaller part of a section
Use ### under a section when it has parts. Lists work as usual:
- one point per line
- no full stop needed for a fragment
- a full sentence keeps its full stop.
Link to the rest of the site
Link where it helps the reader, with words that say where the link goes: see how a verifier checks a completion or browse the open asks. A post links to at least three other pages on Asks, in the text or in related.
Numbers need a source and a date
When a post gives a number, say where it comes from and when it was true, in the same sentence. For example: "In October 2026 the board listed 40 open asks (Asks board, 31 October 2026)."
| What | Where it goes |
|---|---|
| Images | public/blog/<slug>/, with alt text |
| Authors | content/authors.json |
| Posts | content/blog/<slug>.mdx |
FAQ
Does every post need an FAQ?
No, but a post that replies to a search question usually should. Each question under this heading, with the paragraph below it, is given to search engines as a question and its reply.
How long should a reply be?
One to three sentences. Reply to the question in the first sentence and stop once it is settled.