Role-play

Pretend you are the docs lead

Pretend you are the docs lead and force the docs package to survive questions about who can ship a page without review, how IA rewrites are timed, and which changelog formats still lack a named owner when product wants speed.

This seat sits between the repo and the pages developers will actually read. It asks which IA trees invent completeness, which changelog templates look crisp on a slide and soft in the feed sample, and what happens when a sample app skips a version pin because the policy is incomplete. A green docs board does not answer those questions. The review needs the IA map, changelog fields, sample app rules, and the named person who can freeze a publish path.

Brief the seat with real artifacts

Hand over the docs tools in use, IA draft, changelog template, sample app inventory, last rewrite outcomes, and one recent incident where a bad page hurt customers or support load. Include which product promises still bypass the same review. State the decision: clear the docs change, revise specific controls, or hold until a publish freeze owner is named.

The docs lead can challenge untested IA trees, changelogs that ignore deprecation windows, sample apps without a completion deadline, and override paths without logging. Product outcome ownership stays with the product lead. Agency spend ceilings belong in the same packet so a quiet invoice does not hide a brittle publish path.

Questions that require dates and owners

  • Which critical task path still lacks a tested page with a measured time-to-complete, and who owns the gap?
  • What must hold before an IA rewrite can promote a tree into the public index, and who can waive it without a written reason?
  • How does a declined draft become visible to the requester within the claimed window?
  • What is the measured time from a failed sample app finding to a human with take-down authority?
  • Which shared override can ship many pages without failing a single docs health check?
  • Who has authority to pause publish or force an IA rollback at quarter end without waiting for the channel owner?

Label claims as observed, inferred, or unknown. Observed claims need a source. Unknowns become owners and due dates. When two teams claim the same publish authority, force one named decision before the next IA change starts.

Convert pushback into ship gates

Run the role in Pingpong with the same exhibits the docs team will use. Have the home team answer each objection in writing. The useful output is a short publish ledger: approved trees, blocked trees, changelog windows, and the person who can call a freeze.

For IA plans, pair this seat with a docs IA rewrite review. For changelog timing, add an API changelog format stress test. Sample app risk often needs a sample app policy review. The war-game decisions hub has more seats. Before approving the package, make the docs lead write the exact freeze and page check that will decide whether the change continues.