Toimivan tietojärjestelmä­kuvauksen laatiminen

Paljon dokumentaatiota ei ole yhtä kuin hyvä dokumentaatio

Tietojärjestelmädokumentaatio on perinteisesti ollut haastava alue. Liian usein tilanne on se, että yksityiskohtaista dokumentaatiota on paljon, mutta silti oleellisia asioita puuttuu.

Toimivan tietojärjestelmäkuvauksen laatiminen -koulutuksen aikana opit tuottamaan tietojärjestelmäkuvauksen, joka aidosti palvelee sekä kehittäjiä että ylläpitoa, kestäen myös aikaa sekä muutoksia.

Kattava tietojärjestelmäkuvaus sisältää tietojärjestelmän rakenteet, toiminnallisuudet, käsiteltävät tiedot sekä tietojenkäsittely-ympäristöt. Mikä osa tästä on kehityksen aikaista suunnitteludokumentaatiota ja mikä taas ylläpitäjälle tarkoitettua, on oleellinen rajanveto? Opit rajaamaan tietosisällön olennaiseen ja valitsemaan kuhunkin tilanteeseen tarkoituksenmukaisimmat kuvaukset. Harjoittelet, miten järjestelmän elinkaari kuvataan siten, että dokumentaatio säilyy ajantasaisena ja käyttökelpoisena myös tuotantovaiheen jälkeen. 

Moderni dokumentointimalli, jota koulutuksessa käydään läpi, taipuu niin yksittäisen järjestelmän kuin organisaatiotasoisen kokonaisuuden kuvaamiseen. Malli toimii yhdessä uusien työvälineiden ja ketterien menetelmien kanssa.