AsksOpen AsksPro Asks

Sandbox · nothing here is real money · How does this work?

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.

By Example WriterUpdated 2 min read

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 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)."

WhatWhere it goes
Imagespublic/blog/<slug>/, with alt text
Authorscontent/authors.json
Postscontent/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.