Teknisk dokumentation
At skrive det ned, så den næste kan følge med
Overdragelser, driftsvejledninger og manualer, der lader jeres egne folk drive systemet uden at ringe til den, der byggede det.

Foto: jessica45 / Pixabay 
Foto: stevepb / Pixabay
Udvalgte resultater, der demonstrerer denne ydelse.
-
Én infrastrukturplan til 14 afdelinger
Har designet en omfattende infrastrukturramme for et forskningsinstitut, der omfatter 14 afdelinger, med fleksible moduler, samlede datapipelines og strukturerede supportstrategier, der sikrer langsigtet forankring.
-
Har leveret 8 Power BI‑projekter med manualer
Har gennemført 8 Power BI‑projekter med grundige manualer og integreret Microsoft Power BI‑værktøjer med NodeJS API og Python FastAPI til effektiv dataanalyse og visualisering.
-
Har skrevet 50.000 ord softwaredokumentation
Har skrevet 50.000 ord omfattende softwaredokumentation med Markdown i GitHub, Craft og Confluence og derved sikret fastholdelse af viden og gennemsigtighed i processen.
-
Har migreret API'et til Huma v2 med 100 % paritet
Har migreret HTTP‑API'et fra Fiber til Huma v2 — 649 paths og 760 operationer — og opnået og fastholdt 100 % paritet mellem de ruter, serveren registrerer, og den OpenAPI‑beskrivelse, den udgiver.
-
Har skrevet 578 go‑task‑automatiseringsmål
Har skrevet 578 go‑task‑automatiseringsmål, der dækker udviklingstilstandene native, Docker og HTTPS, linting, test, database og udrulning.
-
Har bygget en kontrolmotor med 268 tjek
Har bygget repositoryets kontrolmotor — 268 registrerede commit‑tjek, 277 lint‑regler og 15 egne ESLint‑regler — plus 146 tests af selve tjekkene, så det er builden, der holder standarden, ikke reviewet.
-
Har kørt et løbende sikkerhedsscanningsprogram
Har etableret et løbende sikkerhedsprogram — code scanning, DAST, afhængigheds- og sårbarhedstjek, SBOM‑generering, secret scanning og SHA‑pinnede actions — sammen med 21 skriftlige sikkerhedsgennemgange.
-
Har bygget 7 skrivebeskyttede rapporteringsroller
Har bygget syv skrivebeskyttede rapporteringsroller, der gengiver den kørende vært som Markdown — fakta, adgang, git, metrikker, trafik, sikkerhed og udbyderinventar — efter en regel om, at der ikke udskrives et tal, kørslen ikke selv har målt.
-
Har skrevet en afgrænsningsregel efter et læk
Har skrevet en afgrænsningsregel ind i repositoryet, efter at en omstrukturering havde ført en anden virksomheds inventar, firewalltilladelser og tekst med ind i det — og holdt de karantænesatte rester under hemmelighedsscanneren i stedet for at udelukke dem.
-
Har bygget en commit‑gate med 22 lintere
Har bygget en commit‑gate med 22 lintere, der hver kan beskrives på én linje, plus fem, der fortjener et afsnit, uden advarselsniveau og uden tilladte inline‑undertrykkelser, og som dækker HTML, CSS, JavaScript, Python, YAML, Markdown, shell, links, stavning, hemmeligheder og typografi.
-
Har kørt udvikling som 51 nedskrevne initiativer
Har styret sitets udvikling som 51 nedskrevne initiativer fordelt på 54 plandokumenter, hvert med sine åbne afkrydsningsfelter, sine målinger og de beslutninger, det fravalgte — herunder seks af otte fund om agentparathed, der blev afvist med begrundelsen noteret.
-
Har sat dokumentationen under sin egen linter
Har sat dokumentationen under sin egen linter — et linjebudget pr. fil, der kun kan sænkes, et indekskrav og et tjek af faktiske stier — som fandt seks af ni planer markeret som færdige, selvom de stadig havde felter, der ikke var krydset af, og fjorten opgaver, der spærrede hver commit uden at være nævnt i noget dokument.
-
Har opnået PDF/UA‑1‑konformitet: 106 af 106
Har opnået PDF/UA‑1‑konformitet i ni dokumenter med 106 af 106 regler opfyldt og fundet, at arkivvarianten fejlede på én regel ud af 146 — så tæt på, at det ligner bestået for enhver, der ikke kører validatoren.
-
Har fundet uenighed mellem hooks og kvalitetsgate
Har opdaget, at commit‑hooks og kvalitetsgaten kørte forskellige tjek, selvom et dokument lovede, at de var de samme, ved at sammenligne de to lister i en test — de fem, der kun nogensinde blev kørt manuelt, var dem, der læste CV‑prosaen.
-
Har bygget et tværsprogligt tjek af tal
Har bygget et tværsprogligt indholdstjek, der fejler, når en oversættelse udelader et tal, som den engelske tekst angiver, og når et sprog bruger en notation, der ikke hører til det — og fundet to danske beskrivelser, der manglede en metrik, og seksten ukrainske tekststykker med citationstegn på engelsk vis.
-
Har skrevet en parser, der tjekker hvert FFI‑kald
Har skrevet en parser, der læser den rigtige C‑header på 7.308 linjer og verificerer hvert kaldssted, hver enum‑konstant, og at hver klasse, der ejer en pointer, er final, efter at en håndskrevet pladsholder‑header lod kald til tre fjernede funktioner kompilere, linke og crashe.
-
Har renset fejlbeskederne for bebrejdelser
Har omskrevet applikationens fejlbeskeder efter en nedskrevet standard for tone, efter at et afvist login gav brugeren skylden for at have tastet forkert, mens udbyderen i virkeligheden krævede en applikationsspecifik adgangskode, og dækket det med en test, der nævner udbyderen.
-
Har holdt 4 repositories på én historikstandard
Har holdt fire repositories på én standard for historikken — konventionel, uden emojis, uden attributionslinjer, håndhævet af en commit‑message‑hook — sammen med 48 instruktionsdokumenter, der styrer, hvordan arbejdet udføres.
-
Har fået seks indsamlere til at melde det ulæste
Har fået seks rapporteringsindsamlere til at oplyse den del af deres input, de aldrig læste — uåbnede filer, ikke‑installerede sonder og ugenkendte journallinjer — og tilpasset tærskler til 116 målte stikprøver efter at have fastslået, at en blind indsamling og en rask vært giver den samme side.
Hvis det er det arbejde, du har brug for, er næste skridt en samtale.
Fortæl os problemet, så siger vi ærligt, om vi er de rette til det.

