Avatar billede danic Nybegynder
23. juni 2003 - 13:40 Der er 1 kommentar og
2 løsninger

Brainstorm på IT-dokumentation

Jeg bar brug for en brainstorm omkring IT dokumentation, jeg tænker ikke så meget på udvikling, men på drift dokumentation.

Hvad er dokumentation godt for?
Kan det overhoved bruges til noget?
Udarbejder i dokumentation eller har i overhoved tid til det?
Kan man stole på dokumentaion?
Hvor tit skal dokumentationen opdateres? bliver den det?
...

Lad mig høre alle jeres erfaringer?
Avatar billede bufferzone Praktikant
23. juni 2003 - 13:48 #1
Hvad er dokumentation godt for:
Absolut nødvendig til at dokumentere hvad der er lavet og hvad der er sket. Uden dokumentation kan du ikke styre sikkerheden (hverken drift sikkrehed eller systemsikkerhed), uden dokumentation vil du ikke være i standt til at identificere sikkerhedsbrud. Uden denne dokumentation bruger du på sigt uforholdsmæssig lang tid til at finde grundlag og løsninger, der allerede findes i systemet, du spilder således meget tid. Uden dokumentation er du bundet til dine folk, forsvinder der en mand, forsvinder hans viden også og en ny mand skal gennem se systemet for at finde ud af hvordan ting er sadt op og hvordan procedure virker.
Kan det overhoved bruges til noget?

Som sagt: sikkerhed, effektiv drift, datamining hvor du gennemser historik for at finde mønstre,
Udarbejder i dokumentation eller har i overhoved tid til det?
Det er der et formelt krav om at vi skal, det er en del af mit arbejde og gør jeg det ikke udfører jeg ikke det arbejde jeg afløndes for

Kan man stole på dokumentaion?
Ja hvis den er lavet ordentligt, dette bør være kravfastsat af firmaets ledelse

Hvor tit skal dokumentationen opdateres? bliver den det
Hele tiden og løbende, bliver den ikke det, er den intet værd. Lav dokumentationen web basseret med et CMS system, så opdatering bliver let
Avatar billede overchord Nybegynder
23. juni 2003 - 13:55 #2
Dokumentation er et mareridt at srive, og halter ofte som en del af processen. Men naar det er sagt er det stadig strent, strengt, strengt noedvendigt!
Hvis vi taler job-situationer er der ikke noget mere katastrofalt end at arve en stak udokumenteret "legacy-kode" og saa skulle proeve at finde hoved eller hale i det uden dokumentation.
Hvis vi taler GPL eller anden open source er dokumentationen noedvendig hvis du vil se en fornuftgit videre udvikling af produktet. Og undgaa en masse overfloedige bug-reports.
Hvis det er din egne personlige projekter er det godt nok rart at sidde og kunne hurtigt laese sig frem til hvorfor man nu lige gjorde det paa den maade.
Jeg arbejder mest med databaser og har som saadan ikke andre personer der pt udvikler/aendrer paa produkterne i drift. Og jeg skal da aerligt indroemme at det ikke er alle dele der er lige vel dokumenteret, men dette afspejles ogsaa direkte i den tid det tager at rette eller forbedre disse dele af databasen.
Dit spoergsmaal om det er muligt at stole paa dokumentationen: Det afhaenger jo altid totalt af personen der har udviklet det og om han/hun har en egentligt interesse i at skrive det ordentligt. Selv mener jeg at dokumentationen udgoer en vaesentligt del af udviklingen, og en mindre del af driften.
Jeg bruger den praksis at der ikke slettes froa dokumentationen selv efter forbedringer. Istedet tilfoejese kommentarer eller opdateringer. Nogle finder denne metode rodet, men jeg faar en bedre fornemmelse af hvordan forbedringerne er kommet paa plads, hvilke dele der har vaeret arbejdet meget med osv.
Men i bund og grund er dokumentation altid saarbar idet den aldrig bliver bedre end den maengde tid der investeres. Og et fuldt dokumenteret projekt kan i den henseende vaere "ubrugeligt" efter et aars drift og rettelser hvis dokumentationen ikke er opdateret.
Men det er selv bare min mening .....
Avatar billede danic Nybegynder
24. juni 2003 - 12:27 #3
Tak for de 2 svar!!
Avatar billede Ny bruger Nybegynder

Din løsning...

Tilladte BB-code-tags: [b]fed[/b] [i]kursiv[/i] [u]understreget[/u] Web- og emailadresser omdannes automatisk til links. Der sættes "nofollow" på alle links.

Loading billede Opret Preview
Kategori
IT-kurser om Microsoft 365, sikkerhed, personlig vækst, udvikling, digital markedsføring, grafisk design, SAP og forretningsanalyse.

Log ind eller opret profil

Hov!

For at kunne deltage på Computerworld Eksperten skal du være logget ind.

Det er heldigvis nemt at oprette en bruger: Det tager to minutter og du kan vælge at bruge enten e-mail, Facebook eller Google som login.

Du kan også logge ind via nedenstående tjenester