Teknisk dokumentasjon
Skrive det ned, så den neste kan følge det
Overleveringsdokumenter, driftsinstrukser og håndbøker som lar dine egne ansatte drifte systemet uten å ringe den som bygde det.
Utvalgt arbeid som viser denne tjenesten.
-
Én infrastrukturplan for 14 avdelinger
Designet et felles rammeverk for et forskningsinstitutt som 14 avdelinger kunne bruke i fellesskap, og der hver avdeling beholdt det som gjør den særegen.
-
Leverte 8 Power BI‑prosjekter med veiledninger
Leverte 8 analyseprosjekter i Power BI (Node.js-API, Python FastAPI) med fullstendige brukerveiledninger og gjorde rapportgenereringen 60 % mer effektiv.
-
Skrev 50 000 ord programvaredokumentasjon
Skrev 50 000 ord programvaredokumentasjon i GitHub, Craft og Confluence og gjorde kunnskapen varig, transparent og etterprøvbar.
-
Migrerte API‑et til Huma v2 med 100 % paritet
Migrerte HTTP-API-et fra Fiber til Huma v2 — 649 stier, 760 operasjoner — med 100 % samsvar mellom registrerte ruter og den publiserte OpenAPI-beskrivelsen.
-
Skrev 578 automatiseringsmål i go‑task
Skrev 578 automatiseringsmål i go-task for modusene native, Docker og HTTPS — linting, testing, database og produksjonssetting bak én verktøykjede.
-
Bygde repoets kontrollmotor med 268 kontroller
Bygde en kontrollmotor med 268 registrerte commit-kontroller, 277 lint-regler og 15 egne ESLint-regler, med 146 tester av selve kontrollene.
-
Drev et løpende program for sikkerhetsskanning
Etablerte et kontinuerlig sikkerhetsprogram — kodeskanning, DAST, avhengighetskontroller, SBOM, hemmelighetsskanning og låste actions — pluss 21 revisjoner.
-
Bygde 7 skrivebeskyttede rapportroller for verter
Hele driftsmiljøet kan beskrives fra repoet ved behov, og rapportene har funnet virkelige ting: de to døde sikkerhetstiltakene, en ikke-deklarert lyttende port…
-
Skrev en avgrensningsregel etter tilgangslekkasje
Omfangsgrensen er en skriftlig regel med en oppgitt test, restene er synlige i stedet for begravd, og den konkrete formen for påloggingsopplysning som slapp…
-
Bygde en commit‑port med 22 lintere
Mekaniske innvendinger kommer fra en maskin før en commit finnes, og kvalitetsporten er den eneste som gjennomgår endringer i dette prosjektet.
-
Drev utviklingen som 51 skriftlige initiativer
Femtien beslutninger med tilhørende begrunnelse, omtrent tre fjerdedeler lukket, og de avslåtte er like lette å finne fram til som de aksepterte.
-
La dokumentasjonen under sin egen linter
Tjueseks dokumenter på til sammen omtrent 2 666 effektive linjer, hvert under et budsjett som ikke kan vokse, med hver sti og hvert symbol de nevner…
-
Nådde PDF/UA‑1‑samsvar på 106 av 106
Samsvar med kravene til universell utforming er bevist med full score, og arkivpåstanden er ærlig oppgitt som nesten oppfylt, med det konkrete avviket…
-
Fant at hookene og porten var uenige
Hooken og porten kjører beviselig de samme kontrollene, og prosakontrollene kjører nå ved hver commit.
-
Bygde en tallkontroll på tvers av språk
Atten reelle feil ble lukket, og hele feilklassen med dem, siden hver fremtidige oversettelse sammenlignes med sin engelske kilde før den kan committes.
-
Skrev en parser som verifiserer hvert FFI‑kall
Den feiltypen som ga den opprinnelige krasjen, kan ikke komme tilbake, fordi en utdatert referanse nå er en byggefeil og ikke en kjøretidsfeil.
-
Skrev om feilmeldingene som skyldte på brukerne
Feilmeldingene følger en uttalt standard, og tilfellet som utløste den, er dekket av en test som feiler på den gamle teksten.
-
Holdt 4 repoer til én historikkstandard
Fire repoer deler ett historikkformat og én instruksjonsstruktur, og begge håndheves av hooks i stedet for av disiplin.
-
Fikk seks innsamlere til å si hva de hoppet over
En side med tall fra denne plattformen viser nå sine egne blindsoner ved siden av funnene. Ingen del av selvmålingen er en port, og det er sagt rett ut og ikke…
Er dette arbeidet du trenger gjort, er neste skritt en samtale.
Fortell oss problemet, så sier vi ærlig fra om vi er de rette folkene.