# Satte dokumentationen under en egen linter — en radbudget per fil som bara kan skruvas nedåt, ett krav på index och en kontroll av verkliga sökvägar — som hittade sex av nio planer markerade som klara trots okryssade rutor, och fjorton commit‑spärrande uppgifter som inget dokument nämnde. augusti 2026 **Situation.** Repot styr sig självt med skrivna instruktioner — tjugosex dokument som täcker kvalitetspolicyn, designsystemet, tillgänglighet, utskrift, metadata, översättning och git. Instruktioner har ett specifikt förfallsmönster: de blir längre, de glider ifrån koden, de börjar hänvisa till filer som har flyttats, och vid en viss storlek slutar de att läsas. En regel som ingen läser är ingen regel. **Uppgift.** Dokumentationen behövde samma behandling som koden — en linter med gränser som fallerar i stället för att ge råd. **Handling.** Åtta policyer, var och en mekanisk. Ett hårt tak för dokumentlängd och ett mjukare som varnar. En radbudget per fil som bara kan sänkas, så att ett dokument kan krympa men inte växa tillbaka. Ett krav på innehållsförteckning över ett tröskelvärde, och en avsnittsförteckning över ett lägre. En placeringsregel om vilket dokument som äger vilket ämne. Giltiga länkar. Ärlighet i planerna — den status en plan anger måste stämma med dess egna kryssrutor. En regel om att varje uppgift som spärrar en commit är namngiven i något dokument. Och en kontroll av verkliga sökvägar, att varje katalogkvalificerad sökväg och varje kodsymbol som ett dokument nämner faktiskt finns. Den första körningen var argumentet för hela övningen: sex planer som var markerade som klara men fortfarande hade okryssade rutor, fjorton uppgifter som spärrade varje commit och som inte nämndes i något dokument alls, tre trasiga länkar, ett föräldralöst dokument och tre döda sökvägar i fem dokument. Budgeten stoppade sedan sin egen upphovsperson — när sammanfattningen av detta arbete skrevs in i utvecklingsdokumentet gick det över sin gräns, och det var så ett separat dokument kom till, vilket är policyn som fungerar precis som avsett. **Resultat.** Tjugosex dokument på sammanlagt ungefär 2 666 effektiva rader, vart och ett under en budget som inte kan växa, och varje sökväg och symbol som de nämner kontrolleras mot trädet. Det obekväma fyndet är det som är värt att upprepa: fjorton kontroller spärrade varenda commit utan att förekomma i något dokument, så reglerna som maskinen upprätthöll och reglerna som människorna läste hade redan glidit isär. --- - Roll: Teknisk produktchef - Kategorier: [Automatisering och CI/CD](https://engineer.company/sv/categories/automation/), [Test och kvalitetssäkring](https://engineer.company/sv/categories/testing/), [Python](https://engineer.company/sv/categories/python/), [Tekniskt ledarskap](https://engineer.company/sv/categories/technical-leadership/), [Projektledning](https://engineer.company/sv/categories/project-management/), [Dokumentation](https://engineer.company/sv/categories/documentation/) - Tjänster: [Tekniskt ledarskap och rådgivning](https://engineer.company/sv/services/technical-leadership/), [Projektledning (agil)](https://engineer.company/sv/services/project-management/), [Teknisk dokumentation](https://engineer.company/sv/services/technical-documentation/)