Skip to content

Latest commit

 

History

History
37 lines (25 loc) · 1.44 KB

File metadata and controls

37 lines (25 loc) · 1.44 KB

House Style — Dana's Blog

Who we write for

Small-business owners who are smart but time-poor. Friendly, concrete, no jargon.

Voice

  • Short sentences. Active voice. Second person ("you").
  • One idea per paragraph. Concrete examples over abstractions.
  • US English spelling.

Hard rules (non-negotiable)

  • Every factual claim must be traceable to a source in research/<slug>.md.
  • No statistics, prices, dates, or quotes that are not in the notes.
  • Never invent sources. If the notes don't support a claim, cut the claim.
  • Articles are 500–700 words with a title, a 1-sentence summary, and 3–5 sections.

File naming

Every post gets one <slug> (kebab-case, derived from the title) that is shared across all of its artifacts, so each run is traceable and runs never overwrite each other. The editor assigns the slug once and passes it to every specialist.

Pipeline

  1. The researcher writes sourced notes to research/<slug>.md.
  2. The copywriter writes the draft to drafts/<slug>.md from the notes.
  3. The proofreader fact-checks and proofs it, writing the result to for_review/<slug>.md.

Definition of done

A draft in drafts/<slug>.md that follows the voice, hits the word count, and where every claim maps to a note, plus a proofed, fact-checked version in for_review/<slug>.md. for_review/<slug>.md is the artifact Dana reviews. The agents stop there — Dana publishes manually. Nothing is published by the workshop.