Documentation Writing Skill

Use references/metabase-style-guide.md guide when writing or editing Metabase documentation. It sets the default tone, structure, and formatting so people can get answers fast and trust the steps.

When writing documentation

Start here

1. Who is this for? Match complexity to audience. Don't oversimplify hard things or overcomplicate simple ones.
2. What do they need? Get them to the answer fast. Nobody wants to be in docs longer than necessary.
3. What did you struggle with? Those common questions you had when learning? Answer them (without literally including the question).

Writing process

Draft: