Examples

One small grammar · several kinds of inquiry


Find a note close to your work. Compare the writing with the connections its marks make explicit, then borrow just the part you need.

Software

API timeout investigation

Competing diagnoses, retained evidence, a reply, and an unresolved timing check.

9 marked points · 8 explicit connections

Source

- API Timeout Investigation
  - [Q] Why are requests timing out after deployment?
    - [C? @db-pool] The timeout is caused by database connection pool exhaustion.
      - [G @acq-fail] Error logs show repeated connection acquisition failures.
        - [@prod-logs ~> @acq-fail] Production logs from 02:00–03:00.
      - [O] Increased upstream latency may be the actual cause rather than a downstream symptom.
        - [G] The same logs also show increased upstream latency.
        - [R; @temporal-rebuttal] Upstream latency begins after connection failures, not before.
          - [? ~> @temporal-rebuttal] Need timestamp ordering across services.
      - [D] Distinguish root cause from downstream symptom.

Compiled structure

  1. QQuestionWhy are requests timing out after deployment?
  2. C?Open ClaimThe timeout is caused by database connection pool exhaustion.
  3. GReasonError logs show repeated connection acquisition failures.
  4. MMaterialProduction logs from 02:00–03:00.
  5. OObjectionIncreased upstream latency may be the actual cause rather than a downstream symptom.
  6. GReasonThe same logs also show increased upstream latency.
  7. RReplyUpstream latency begins after connection failures, not before.
  8. ?Open gapNeed timestamp ordering across services.
  9. DDistinctionDistinguish root cause from downstream symptom.
  1. Open Claim @db-poolanswersQuestion
  2. Reason @acq-failsupportsOpen Claim @db-pool
  3. Material @prod-logsis aboutReason @acq-fail
  4. ObjectionchallengesOpen Claim @db-pool
  5. ReasonsupportsObjection
  6. Replyreplies toObjection
  7. Open gapis aboutConnection @temporal-rebuttal
  8. DistinctionclarifiesOpen Claim @db-pool