liveBook · Manning

Draft

As explained in Writing for Developers: Blogs that get read

A draft is a preliminary version of a written work that has not been published.

A working draft is a fast, incomplete version of a technical article: an MVP that captures the core ideas so they can be reviewed, improved, and eventually published. Its first job is to exist, not to be elegant. section 4.0 section 4.1

Use different mindsets at different stages: make it work, then make it right, then make it fast. During drafting, prioritize distinctive experience, technical substance, and complete coverage over titles, hooks, grammar, diagrams, or perfect sentences. section 4.1 section 4.8

Build a draft that can move forward:

  • Define the goal, audience, and distinctive perspective before writing; these decisions guide what to include, cut, and review. section 4.2 section 4.7
  • Create an outline, mind map, or simple list, then add notes, discussions, test results, links, and other raw material to the draft file. section 4.3.1 section 4.3.4
  • Write in any order. Skip intimidating sections, leave placeholders, and use a short timer instead of stopping to edit. section 4.4.2 section 4.8
  • Fill obvious gaps, then check whether the draft covers its intended points, adds enough technical detail, and reflects specialized experience. section 4.6 section 4.6.3
  • Send it for review once due diligence is complete, rather than waiting for every sentence to sound polished. section 6.4.3 section 6.4

A deliberately rough technical post

A first attempt about building a Zig data migration tool can be written in under 30 minutes. It may lack proofreading and copy-editing, but it gives the writer something concrete to inspect for missing ideas, weak focus, and insufficient technical depth. section 4.0 section 4.5

After the raw material is present, switch modes. Read the draft aloud, clarify clumsy sentences, break up large paragraphs, and focus revision on prominent or reader-critical passages. A rough sentence is useful because it gives you something concrete to debug. section 5.3 section 5.3.4

How Writing for Developers: Blogs that get read covers it

How deep it goes
Explains preparation, rapid drafting, blockers, gap checks, and review readiness, while deferring detailed optimization to a later phase.
Examples
Uses a rough Zig data migration article, copied project notes, test results, placeholders, and sentence-level before-and-after revision.
What it assumes
Assumes a topic idea and asks writers to establish the audience, goal, and distinctive perspective before drafting.
What you can do after
Build it from scratch as a reviewable technical article by defining its purpose, capturing its substance, filling gaps, and preparing it for feedback.
How it connects
Connects drafting with outlining, mindmapping, generative AI, revision, technical review, clarity review, and publication.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Writing for Developers: Blogs that get read. The section links point to the parts of the book it draws on.