Documentation Templates

Templates for creating new documentation in the Eko repository.


Available Templates

TemplatePurposeTarget Directory
architecture.mdArchitecture documentationdocs/architecture/
dev-guide.mdDeveloper guidesdocs/dev/
product.mdProduct documentationdocs/product/
runbook.mdOperational runbooksdocs/runbooks/
spec.mdTechnical specificationsdocs/specs/
README.mdSection index pagesAny docs/*/ directory
fix-report.mdBug fix reportsdocs/reports/fixes/
feature-report.mdFeature update reportsdocs/reports/features/
proposal.mdDesign proposalsdocs/proposals/

Usage

Using docs:new Script

# Create a new document from template
bun run docs:new --scope <scope> --title "Title"

# List available scopes
bun run docs:new --list-scopes

Manual Creation

  1. Copy the appropriate template
  2. Rename using kebab-case: YYYY-MM-DD-short-description.md (for updates/proposals)
  3. Replace {{TITLE}} and {{DATE}} placeholders
  4. Fill in the sections

Template Variables

VariableDescriptionExample
{{TITLE}}Document title"Render Worker Auto-Wake"
{{DATE}}Creation date (YYYY-MM-DD)"2026-01-01"