# Har sat dokumentationen under sin egen linter — et linjebudget pr. fil, der kun skruer nedad, et indekskrav og et tjek af faktiske stier — som fandt seks af ni planer markeret som færdige, mens de bar uafkrydsede felter, og fjorten opgaver, der spærrede hver commit uden at være nævnt i noget dokument.

2025

**Situation.** Repositoryet styrer sig selv med skrevne instruktioner — femogtyve dokumenter der dækker kvalitetspolitikken, designsystemet, tilgængelighed, print, metadata, oversættelse og git. Instruktioner har et bestemt forfaldsmønster: de bliver længere, de driver væk fra koden, de begynder at henvise til filer der er flyttet, og ved en vis størrelse holder de op med at blive læst. En ulæst regel er ikke en regel.

**Opgave.** Dokumentationen havde brug for den samme behandling som koden — en linter med grænser der fejler frem for at råde.

**Handling.** Otte politikker, hver mekanisk. Et hårdt loft over dokumentlængde og et blødere der advarer. Et linjebudget per fil, der kun nogensinde skruer nedad, så et dokument kan skrumpe og ikke vokse tilbage. Et indekskrav over en tærskel og et afsnitsindeks over en mindre. En placeringsregel om hvilket dokument der ejer hvilket emne. Linkgyldighed. Planærlighed — den status en plan påstår, skal svare til dens egne afkrydsningsfelter. En regel om at hver opgave der spærrer et commit, er navngivet i et eller andet dokument. Og et tjek af virkelige stier, at hver katalogkvalificeret sti og hvert kodesymbol et dokument navngiver, faktisk findes. Den første kørsel var argumentet for hele øvelsen: seks planer markeret som færdige, mens de bar uafkrydsede felter, fjorten opgaver der spærrede hvert commit og var navngivet i intet dokument overhovedet, tre brudte links, ét forældreløst dokument og tre døde stier fordelt på fem dokumenter. Budgettet afviste derefter sin egen forfatter — at skrive sammendraget af dette arbejde ind i udviklingsdokumentet skubbede det over grænsen, hvilket er sådan et særskilt dokument opstod, hvilket er politikken der virker præcis efter hensigten.

**Resultat.** Femogtyve dokumenter på i alt omkring 2.568 effektive linjer, hvert under et budget der ikke kan vokse, med hver sti og hvert symbol de navngiver tjekket mod træet. Det ubehagelige fund er det der er værd at gentage: fjorten tjek spærrede hvert eneste commit, mens de optrådte i intet dokument, så de regler maskinen håndhævede, og de regler menneskene læste, var allerede kommet fra hinanden.

---

- Rolle: Teknisk produktchef
- Kategorier: [Automatisering & CI/CD](https://engineer.company/da/categories/automation/), [Test & QA](https://engineer.company/da/categories/testing/), [Python](https://engineer.company/da/categories/python/), [Teknisk ledelse](https://engineer.company/da/categories/technical-leadership/), [Projektledelse](https://engineer.company/da/categories/project-management/), [Dokumentation](https://engineer.company/da/categories/documentation/)
- Ydelser: [Teknisk ledelse & rådgivning](https://engineer.company/da/services/technical-leadership/), [Projektledelse (Agile)](https://engineer.company/da/services/project-management/), [Teknisk dokumentation](https://engineer.company/da/services/technical-documentation/)

<https://engineer.company/da/portfolio/put-the-documentation-under-its-own-linter-142/>
