1. Writing Decision Records intermediate

    A team writes decision records that nobody reads and that do not help when the decision is revisited years later. What is missing?

    2 min answer adrrationaleexpirywriting
  2. Writing Decision Records intermediate

    What makes an architecture decision record valuable two years later, and which parts do teams consistently omit?

    3 min answer adrdocumentationcontextdecision
  3. Writing Decision Records intermediate Multiple choice

    Which section is missing from most architecture decision records, and why does it matter?

    2 min answer adrrevisit-conditionsdecisionsevolution
  4. Deployment Diagrams intermediate Multiple choice

    An auditor asks what happens to your service if a single availability zone fails. Which diagram answers the question directly?

    3 min answer deploymentavailability zonesquorumresilience
  5. Deployment Diagrams intermediate

    What does a deployment diagram communicate that a container diagram cannot, and what is most often missing from it?

    2 min answer deployment-diagramtopologyfailure-domainscloudflare
  6. Deployment Diagrams intermediate Multiple choice

    What does a deployment diagram show that a container diagram cannot?

    2 min answer deploymentfailure-domainsredundancyblast-radius
  7. Deployment Diagrams intermediate

    Your deployment diagram shows three availability zones with every service replicated into each and a mesh spreading calls evenly across zones. Finance asks why network charges are $14k of a $90k monthly cloud bill. Estimate the cross-zone traffic implied by that number and say what you would annotate on the diagram.

    3 min answer deployment-diagramcross-zonecostannotation
  8. Documentation Practice intermediate

    A developer platform's users repeatedly build integrations that break on the platform's next release. What communication failure caused this?

    2 min answer supabaseapi-docscompatibilitycontract
  9. Documentation Practice intermediate

    A platform's documentation is comprehensive and developers still get things wrong. What kind of documentation is missing?

    2 min answer documentationguaranteessemanticsdeveloper-experience
  10. Documentation Practice intermediate Multiple choice

    Four team wikis holding about 1400 pages between them are being consolidated into one documentation site for 300 engineers. Analytics show 43 pages serve over half of all reads. Which sequence do you run?

    3 min answer documentationmigrationredirectsretention
  11. Documentation Practice intermediate

    You have two hours to document a system before handing it over. What do you write, and what do you deliberately leave out?

    2 min answer documentationhandoverinvariantsoperations
  12. Presenting to Engineers intermediate

    A platform team's documentation is comprehensive and its users still ask questions it answers. What is wrong with the writing?

    2 min answer dbt-labsdocumentationdeveloper-experiencestructure