Skip to content

Chapter Lifecycle

Rick Viscomi edited this page Jun 24, 2020 · 12 revisions

Chapter Lifecycle

This doc describes the end-to-end process of a Web Almanac chapter, from planning to publishing.

  1. Create content team (project owners)
    • create tracking issues for the chapter
    • assign authors
      • put out a call for nominations for authors
      • vet the nominees and gauge interest
      • select authors for the chapter
    • assign peer reviewers
    • assign data analysts
  2. Plan content (content team)
    • decide on the scope of the chapter
    • decide on what metrics would be needed/feasible
    • brainstorm a chapter outline
    • divide author responsibilities
  3. Testing (analysts)
    • prepare for testing
      • instrument custom metrics to assist analysis
      • write queries
    • run test on HTTP Archive
    • analyze HTTP Archive dataset
      • run queries
      • save data to a spreadsheet
  4. Validate results (content team)
    • review data for comprehension
    • prototype data visualizations
    • resolve bad data
  5. Draft content (content team)
    • write first draft
    • embed data visualizations
    • iterate with technical review feedback
    • submit for publication
  6. Publication (editors, developers)
    • enforce writing style guide
    • enforce data visualization style guide
    • cross-link chapters
    • generate markup
    • update project config
  7. Translation (translators)
    • draft, review, and publish translation