docs: DORA metrics with pipeline timing breakdown #185

New issue

Closed

opened 2026-06-09 10:20:11 +00:00 by ldraney · 0 comments

ldraney commented

2026-06-09 10:20:11 +00:00

Owner

Type

Feature

Lineage

Standalone — no parent plan or phase.

Repo

landscaping-assistant

User Story

As a developer, I want to see measured pipeline timing and DORA metrics so I can identify bottlenecks and track deployment health.

Context

Pipeline #410 deployed the timezone feature. We measured every step from merge to production. This doc captures those measurements with mermaid diagrams and identifies optimization opportunities.

Description

Add docs/DORA.md with:

Deploy chain diagram (Woodpecker → Harbor → Image Updater → ArgoCD)
Gantt chart of pipeline #410 step timing
DORA four key metrics (deployment frequency, lead time, change failure rate, MTTR)
Kaniko build-and-push internals breakdown
Bottleneck analysis and optimization opportunities

File Targets

docs/DORA.md (new)

Feature Flag

None — docs only.

Acceptance Criteria

DORA four key metrics documented with actual measurements
Mermaid diagrams render correctly
Pipeline step timing breakdown is accurate
Bottlenecks and optimization opportunities identified

Test Expectations

No code changes. Mermaid diagrams should render in Forgejo markdown preview.

Constraints

Data sourced from Woodpecker API, Kaniko log timestamps, and pal-e-deployments git log
Timing estimates where API doesn't expose wall-clock per-step (clone, bundle-install, lint, test)

Checklist

Measured pipeline #410 step timing
Documented DORA four key metrics
Added mermaid diagrams
Identified optimization opportunities

Pipeline #410 (timezone feature deploy)
docs/pipeline.md (existing pipeline architecture doc)

### Type Feature ### Lineage Standalone — no parent plan or phase. ### Repo landscaping-assistant ### User Story As a developer, I want to see measured pipeline timing and DORA metrics so I can identify bottlenecks and track deployment health. ### Context Pipeline #410 deployed the timezone feature. We measured every step from merge to production. This doc captures those measurements with mermaid diagrams and identifies optimization opportunities. ### Description Add `docs/DORA.md` with: - Deploy chain diagram (Woodpecker → Harbor → Image Updater → ArgoCD) - Gantt chart of pipeline #410 step timing - DORA four key metrics (deployment frequency, lead time, change failure rate, MTTR) - Kaniko build-and-push internals breakdown - Bottleneck analysis and optimization opportunities ### File Targets - `docs/DORA.md` (new) ### Feature Flag None — docs only. ### Acceptance Criteria - [ ] DORA four key metrics documented with actual measurements - [ ] Mermaid diagrams render correctly - [ ] Pipeline step timing breakdown is accurate - [ ] Bottlenecks and optimization opportunities identified ### Test Expectations No code changes. Mermaid diagrams should render in Forgejo markdown preview. ### Constraints - Data sourced from Woodpecker API, Kaniko log timestamps, and pal-e-deployments git log - Timing estimates where API doesn't expose wall-clock per-step (clone, bundle-install, lint, test) ### Checklist - [x] Measured pipeline #410 step timing - [x] Documented DORA four key metrics - [x] Added mermaid diagrams - [x] Identified optimization opportunities ### Related - Pipeline #410 (timezone feature deploy) - `docs/pipeline.md` (existing pipeline architecture doc)