Skip to content

Document Templates

Templates live outside the Starlight content tree in portfolio-docs/templates so placeholders do not break content validation.

Template Use case
service-overview.md Ownership, criticality, SLA, dependencies and escalation
runbook.md One precise incident or operational problem
postmortem.md Blameless incident review with timeline and action items
adr.md Architecture decision record
checklist.md Pre-flight or post-operation validation list
  1. Copy the template into src/content/docs.
  2. Replace placeholders.
  3. Run bun run check.
  4. Run bun run freshness.
  5. Ask for review before publishing.