2026-02-12 15:46:57 -08:00
|
|
|
|
# Documentation Metrics
|
|
|
|
|
|
|
|
|
|
|
|
**Last Updated:** 2026-01-31
|
|
|
|
|
|
**Document Version:** 1.0
|
|
|
|
|
|
**Status:** Active Documentation
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## Overview
|
|
|
|
|
|
|
|
|
|
|
|
Simple metrics to track documentation health. Update periodically (e.g. monthly or after major doc changes).
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## Metrics Table
|
|
|
|
|
|
|
|
|
|
|
|
| Metric | Target | Last Check | Notes |
|
|
|
|
|
|
|--------|--------|------------|-------|
|
|
|
|
|
|
| **Broken link count (docs/ and root)** | 0 | See reports/BROKEN_REFERENCES_REPORT.md | Prioritize docs/ and root; submodules separate |
|
|
|
|
|
|
| **Docs with standard header** | All active docs | Run `docs/scripts/validate-doc-headers.sh` | Last Updated, Status, --- |
|
|
|
|
|
|
| **MASTER_INDEX / docs/README in sync** | Yes | 2026-01-31 | Directory tree, dates, category links |
|
|
|
|
|
|
| **Last full documentation review** | Quarterly | 2026-01-31 | COMPREHENSIVE_DOCUMENTATION_REVIEW, DOCUMENTATION_FIX_TASK_LIST |
|
|
|
|
|
|
| **Link validation run** | Monthly | — | markdown-link-check or lychee from docs/ |
|
|
|
|
|
|
| **Number of active docs (01–12)** | — | 48+ key docs | MASTER_INDEX counts |
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## How to Update
|
|
|
|
|
|
|
|
|
|
|
|
1. **Broken links:** Run link checker; fix docs-internal and root; update "Last Check" above or this file's date.
|
|
|
|
|
|
2. **Headers:** Run `docs/scripts/validate-doc-headers.sh`; fix failures; re-run until clean (or document exceptions).
|
|
|
|
|
|
3. **Review:** After quarterly review, set "Last full documentation review" to current date.
|
|
|
|
|
|
4. **Link validation run:** After running markdown-link-check/lychee, note date here.
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## Related Documentation
|
|
|
|
|
|
|
2026-02-21 15:46:06 -08:00
|
|
|
|
- [DOCUMENTATION_FIX_TASK_LIST.md](../../00-meta/DOCUMENTATION_FIX_TASK_LIST.md) - All fix tasks
|
|
|
|
|
|
- [DOCUMENTATION_STYLE_GUIDE.md](../../00-meta/DOCUMENTATION_STYLE_GUIDE.md) - Review schedule, validation
|
2026-02-12 15:46:57 -08:00
|
|
|
|
- [COMPREHENSIVE_DOCUMENTATION_REVIEW_2026-01-31.md](COMPREHENSIVE_DOCUMENTATION_REVIEW_2026-01-31.md) - Full review
|
2026-02-21 15:46:06 -08:00
|
|
|
|
- [../../reports/BROKEN_REFERENCES_REPORT.md](../../../reports/BROKEN_REFERENCES_REPORT.md) - Broken refs (repo root reports/)
|
