1. Writing Decision Records intermediate

    A team writes architecture decision records that nobody reads. What makes an ADR useful, and what should it deliberately not contain?

    2 min answer linearadrdocumentationrationale
  2. 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
  3. Writing Decision Records advanced

    What distinguishes a postmortem that changes the system from one that produces a document, and what makes blamelessness a technical practice rather than a cultural nicety?

    3 min answer googlesrepostmortemblameless
  4. 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
  5. 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
  6. 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
  7. 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
  8. Deployment Diagrams intermediate Multiple choice

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

    2 min answer deploymentfailure-domainsredundancyblast-radius
  9. 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
  10. 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
  11. 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
  12. 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