Satte dokumentationen under en egen linter
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.

Kategorier:
1Automatisering och CI/CD	/sv/categories/automation/	engineer.company	70
1Test och kvalitetssäkring	/sv/categories/testing/	engineer.company	70
1Python	/sv/categories/python/	engineer.company	70
1Tekniskt ledarskap	/sv/categories/technical-leadership/	engineer.company	70
1Projektledning	/sv/categories/project-management/	engineer.company	70
1Dokumentation	/sv/categories/documentation/	engineer.company	70

Tjänster:
1Tekniskt ledarskap och rådgivning	/sv/services/technical-leadership/	engineer.company	70
1Projektledning (agil)	/sv/services/project-management/	engineer.company	70
1Teknisk dokumentation	/sv/services/technical-documentation/	engineer.company	70

hDen här sidan på webben	URL:https://engineer.company/sv/portfolio/put-the-documentation-under-its-own-linter/	engineer.company	70
