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.
-
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 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 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 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.

