w5851/doc-coauthoring

Doc Co-Authoring

When to apply

• Writing technical specs, architecture decisions, implementation plans, or paper sections.
• Existing draft needs restructuring, tightening, or consistency cleanup.

Co-authoring stages

1. Context capture
   • Audience, purpose, constraints, and expected decisions.
2. Structure design
   • Build section outline and acceptance criteria per section.
3. Section drafting
   • Draft one section at a time with explicit claims and evidence.
4. Refinement
   • Remove ambiguity, tighten logic flow, unify terminology.
5. Reader check
   • Simulate reader questions and patch weak spots.

Quality checks

• Terms are defined once and used consistently.
• Claims are traceable to data/evidence.
• Scope boundaries and non-goals are explicit.
• Action items include owner and completion signal.

Output style

• Keep headings informative.
• Prefer concise paragraphs and scannable bullets.
• End with decisions, risks, and next steps.