Dokumentasjon uten pistol - går det an?
ea7e7e5f-77ad-4023-a4b8-d09bbcb2e227
 |
Presentation |
Introductory
Methodology and Business
Room:
Lab 2
Timeslot:
17.09.08 13:00
Speaker: Ellen D. Varsi
Alle er enige om at dokumentasjon i systemutviklingsprosjekter er
nødvendig. De fleste synes det er et kjedelig arbeid og vil heller
gjøre andre ting, som f.eks. programmering. Mange skriver lange
dokumenter som blir liggende bortgjemt i skuffer og kott uten å bli
lest. Kanskje heldigvis, siden dokumentene ofte blir utdaterte over
tid og dermed blir både ganske verdiløse og direkte skadelige.
Dokumentasjonsarbeid er tradisjonelt både kostnadskrevende og lite
lystbetont arbeid. Hvilken type dokumentasjon er den viktigste?
Hvordan kan vi gjøre det både enklere, billigere og mer motiverende -
og ikke minst, mer anvendelig?
Dette foredraget gir noen refleksjoner rundt temaet med konkrete
eksempler på hvordan dokumentasjonen kan gjøres mer levende gjennom en
wiki integrert med andre utbredte støtteverktøy som Subversion og
Maven. Vi ser også litt på modellbasert dokumentasjon med UML, hvordan
krav beskrives i brukstilfellemodeller, og hvordan arkitektur kan
dokumenteres.
Outline:
- Presentasjon av meg selv og foredraget
- Litt om hva trenger vi å dokumentere i systemutviklingsprosjekter, og nytteverdien av dette
- Noen erfaringer med wiki-basert doumentasjon
- Noen praktiske eksempler på wiki-basert dokumentasjonsstruktur fra et prosjektteam, bl.a. for krav og arkitektur
- Noen gode råd for sunn dokumentasjon
- Spørsmål og kommentarer
Required experience
None. However, some experience with participating in software
development projects is helpful to understand the real-life challenges
in this part of the work.
Who should attend this session?
Project managers, architects and other participants in software
development projects
How will the participants benefit from attending?
Get some concrete examples of how to manage, communicate and maintain
vital doumentation in software development projects. Get experience
reports and reflections around the theme.
-
Ellen D. VarsiEllen D. Varsi er utdannet fra Høgskolen i Østfold og Universitetet i Oslo, og er idag ansatt som konsulent i javaavdelingen hos Bouvet ASA. Hun har arbeidet i IT-bransjen siden 1988, fortrinnsvis med objekt-orientert systemutvikling på ulike teknologiplattformer. Hun har arbeidet både som utvikler, rådgiver og prosjektleder i både større og mindre prosjekter, og hun har i perioder hatt spesielt fokus på metodikk, kravhåndtering, arkitektur og objektorientert analyse og design med UML. Hun programmerer fremdeles og helst med java.