docs: absorb DORA docs repo into forgejo-mcp/docs/ #29

New issue

Closed

opened 2026-06-13 18:56:58 +00:00 by ldraney · 0 comments

ldraney commented

2026-06-13 18:56:58 +00:00

Owner

Type

Feature

Lineage

Discovered during DORA board migration session 2026-06-13.

Repo

ldraney/forgejo-mcp

User Story

As a platform operator I want DORA documentation next to the Forgejo tooling repo so that docs and code live together and I don't maintain a docs-only repo.

Context

The ldraney/DORA repo is docs-only — 4 markdown files (architecture, metrics reference, tiering, dashboard specs) with no code. Since forgejo-mcp wraps the Forgejo API and git is the heart of DORA, these docs belong here. Eliminates repo sprawl.

File Targets

Files to create:

docs/architecture.md — data flow from Forgejo/Woodpecker through Prometheus to Grafana
docs/metrics.md — every Prometheus metric the exporter emits
docs/tiering.md — repo tier system for Grafana filtering
docs/dashboard.md — current panels, PromQL queries, planned improvements

Files to modify:

README.md — add DORA Docs table linking to local docs

Feature Flag

None needed.

Acceptance Criteria

docs/architecture.md, docs/metrics.md, docs/tiering.md, docs/dashboard.md exist
README links to local docs
ldraney/DORA repo archived after merge

Test Expectations

Docs render correctly in Forgejo web UI
Mermaid diagrams in architecture.md and tiering.md render

Constraints

Content migrated as-is from ldraney/DORA — no rewriting in this ticket

Checklist

PR opened
No unrelated changes

project-dora-metrics updated with action-vs-measurement architecture
7 issues migrated from ldraney/DORA to correct repos

### Type Feature ### Lineage Discovered during DORA board migration session 2026-06-13. ### Repo ldraney/forgejo-mcp ### User Story As a platform operator I want DORA documentation next to the Forgejo tooling repo so that docs and code live together and I don't maintain a docs-only repo. ### Context The ldraney/DORA repo is docs-only — 4 markdown files (architecture, metrics reference, tiering, dashboard specs) with no code. Since forgejo-mcp wraps the Forgejo API and git is the heart of DORA, these docs belong here. Eliminates repo sprawl. ### File Targets Files to create: - `docs/architecture.md` — data flow from Forgejo/Woodpecker through Prometheus to Grafana - `docs/metrics.md` — every Prometheus metric the exporter emits - `docs/tiering.md` — repo tier system for Grafana filtering - `docs/dashboard.md` — current panels, PromQL queries, planned improvements Files to modify: - `README.md` — add DORA Docs table linking to local docs ### Feature Flag None needed. ### Acceptance Criteria - [ ] docs/architecture.md, docs/metrics.md, docs/tiering.md, docs/dashboard.md exist - [ ] README links to local docs - [ ] ldraney/DORA repo archived after merge ### Test Expectations - [ ] Docs render correctly in Forgejo web UI - [ ] Mermaid diagrams in architecture.md and tiering.md render ### Constraints - Content migrated as-is from ldraney/DORA — no rewriting in this ticket ### Checklist - [ ] PR opened - [ ] No unrelated changes ### Related - project-dora-metrics updated with action-vs-measurement architecture - 7 issues migrated from ldraney/DORA to correct repos