Docs, tutorials, and developer content.
2 topics
Know your audience, use plain language, be concise, structure logically. Style guides: Google Developer Docs, Microsoft Writing Style Guide. Use second person, present tense, imperative mood for instructions. Numbered lists for sequential, bullets for non-sequential.
2 resources
Diátaxis framework: tutorials (learning), how-to guides (task), reference (information), explanation (understanding). API docs with OpenAPI/Swagger. READMEs as project front door. Changelogs for release tracking.
Docs-as-code: Markdown/MDX in git repos, CI/CD publishing. Tools: Docusaurus (React), MkDocs Material (Python), GitBook, Nextra (Next.js). Linting with Vale/markdownlint. API docs: Swagger, Storybook, TypeDoc. Interactive examples with CodeSandbox.
Blog posts for organic traffic and thought leadership. Structure: intro (what/why), body (step-by-step + code), conclusion (summary/next). SEO basics: descriptive titles, meta descriptions, proper headings. Code examples must be complete and runnable.