- Length
- About 1,200 to 2,500 words.
- Structure
- Question-style H2 headings, short paragraphs, and a table where you compare things.
- Opening
- A direct answer of 40 to 60 words at the top, as our own guides have.
- Code
- Fenced code blocks with the language named. State the versions you used.
- Sources
- Link primary sources: specifications, official documentation and repositories. List them at the end.
- Images
- Original screenshots or diagrams with alt text. No stock images.
- Links
- Links go to primary sources and relevant documentation. Promotional links are removed in editing. Your author note may carry one link to your site or profile.
- Author note
- Up to 50 words: who you are and what you work on.
- Draft
- Send the outline first. Write the full post once we agree the angle, as Markdown or a shared document.
- Editing
- We edit for accuracy, clarity, length and house style, and may ask you to verify claims. We decide what to publish and when.