Ohjelmistotuotteen dokumentointi : kohdeyrityksenä Agenteq Solutions Oy
Rivinoja, Joonas (2010)
Julkaisun pysyvä osoite on
https://urn.fi/URN:NBN:fi:amk-2010120717252
https://urn.fi/URN:NBN:fi:amk-2010120717252
Tiivistelmä
Agenteq Solutions Oy on kasvava ohjelmistoyritys, joka toimii Salossa ja Helsingissä. Yritys on Suomen markkinajohtaja kiinteistöalan ohjelmistojen tarjoajana sekä lukuisten muiden web-palvelujen kehittäjä. Yrityksen päätuotteita ovat kiinteistötietojärjestelmä Tampuuri sekä julkaisujärjestelmä Latomo.
Tämän opinnäytetyön tarkoituksena on tutkia ja arvioida yrityksen tämänhetkisiä ohjelmistotuotteiden dokumentointikäytäntöjä ja luoda toimivia ratkaisuja, jolla käytäntöjä voidaan kehittää entistä paremmaksi. Dokumentoinnin kehittämisellä haetaan helpompaa ja hallitumpaa tuotteiden ja tietojen ylläpitoa sekä tehokkaampaa tuotekehitystä. Ilman kunnollista dokumentointia ja käytäntöjä kommunikointi yrityksen sisällä ja ulospäin on selkeästi puutteellista.
Käytäntöjen yhtenäistämiseksi eri dokumenttityyppien kesken on luotava niille dokumenttipohjat sekä määrättävä niille toimenpideroolit. Yrityksen dokumentit voidaan jakaa kahteen ryhmään: tuotedokumentit ja projektidokumentit. Yhtenä tärkeänä kehittämisen osa-alueena on myös koodidokumentaatio ja sen automatisointi. Koodidokumentaatiolla pyritään helpottamaan kehitystiimien välistä yhteistoimintaa ja henkilöstön vaihtumista projektien kannalta.
Työ tehtiin ensin tutkimalla yrityksen nykyistä dokumentointikäytäntöjen tilannetta ja suunnittelemalla tulevia tarpeita varten uusia ratkaisuja. Käytössä oleville ja uusille tarvittaville dokumenteille luotiin pohjat, koodidokumentaatio otettiin osaksi kehitystyötä ja dokumenteille luotiin RACI-toimenpidelistat. Lopulta näitä testattiin käytännössä yhdellä projektilla.
Yrityksen dokumentointikäytännön kehitystyön aikana huomattiin selkeitä puutteita. Osa niistä saatiin korjattua edellä mainituilla toimenpiteillä, mutta osa tuloksista tulee esille vasta testausvaiheen jälkeen, kun järjestelmää ja käytäntöjä hiotaan ja henkilöstöä koulutetaan niiden käyttämiseen.
Tämän opinnäytetyön tarkoituksena on tutkia ja arvioida yrityksen tämänhetkisiä ohjelmistotuotteiden dokumentointikäytäntöjä ja luoda toimivia ratkaisuja, jolla käytäntöjä voidaan kehittää entistä paremmaksi. Dokumentoinnin kehittämisellä haetaan helpompaa ja hallitumpaa tuotteiden ja tietojen ylläpitoa sekä tehokkaampaa tuotekehitystä. Ilman kunnollista dokumentointia ja käytäntöjä kommunikointi yrityksen sisällä ja ulospäin on selkeästi puutteellista.
Käytäntöjen yhtenäistämiseksi eri dokumenttityyppien kesken on luotava niille dokumenttipohjat sekä määrättävä niille toimenpideroolit. Yrityksen dokumentit voidaan jakaa kahteen ryhmään: tuotedokumentit ja projektidokumentit. Yhtenä tärkeänä kehittämisen osa-alueena on myös koodidokumentaatio ja sen automatisointi. Koodidokumentaatiolla pyritään helpottamaan kehitystiimien välistä yhteistoimintaa ja henkilöstön vaihtumista projektien kannalta.
Työ tehtiin ensin tutkimalla yrityksen nykyistä dokumentointikäytäntöjen tilannetta ja suunnittelemalla tulevia tarpeita varten uusia ratkaisuja. Käytössä oleville ja uusille tarvittaville dokumenteille luotiin pohjat, koodidokumentaatio otettiin osaksi kehitystyötä ja dokumenteille luotiin RACI-toimenpidelistat. Lopulta näitä testattiin käytännössä yhdellä projektilla.
Yrityksen dokumentointikäytännön kehitystyön aikana huomattiin selkeitä puutteita. Osa niistä saatiin korjattua edellä mainituilla toimenpiteillä, mutta osa tuloksista tulee esille vasta testausvaiheen jälkeen, kun järjestelmää ja käytäntöjä hiotaan ja henkilöstöä koulutetaan niiden käyttämiseen.