Arkkitehtuurin dokumentointi kehittäjän ja ylläpidon näkökulmasta case: Kanta-palvelut

Tietojärjestelmäkehityksessä arkkitehtuurin dokumentoinnilla on suuri merkitys. Merkitys korostuu kehityksen eri vaiheissa, niin uuden työntekijän perehdytyksessä kuin ylläpidossa tuotannon ongelman selvittelyssä. Alan kirjallisuudessa dokumentaation merkitys korostuu erityisesti, kun dokumentaatio...

Full description

Bibliographic Details
Main Author: Mankonen, Tiina
Other Authors: Informaatioteknologian tiedekunta, Faculty of Information Technology, Informaatioteknologia, Information Technology, Jyväskylän yliopisto, University of Jyväskylä
Format: Master's thesis
Language:fin
Published: 2022
Subjects:
Online Access: https://jyx.jyu.fi/handle/123456789/82157
_version_ 1828193052828631040
author Mankonen, Tiina
author2 Informaatioteknologian tiedekunta Faculty of Information Technology Informaatioteknologia Information Technology Jyväskylän yliopisto University of Jyväskylä
author_facet Mankonen, Tiina Informaatioteknologian tiedekunta Faculty of Information Technology Informaatioteknologia Information Technology Jyväskylän yliopisto University of Jyväskylä Mankonen, Tiina Informaatioteknologian tiedekunta Faculty of Information Technology Informaatioteknologia Information Technology Jyväskylän yliopisto University of Jyväskylä
author_sort Mankonen, Tiina
datasource_str_mv jyx
description Tietojärjestelmäkehityksessä arkkitehtuurin dokumentoinnilla on suuri merkitys. Merkitys korostuu kehityksen eri vaiheissa, niin uuden työntekijän perehdytyksessä kuin ylläpidossa tuotannon ongelman selvittelyssä. Alan kirjallisuudessa dokumentaation merkitys korostuu erityisesti, kun dokumentaatio ei ole ajan tasalla tai helposti löydettävissä ja sidosryhmien välisessä kommunikaatiossa. Myös ketterä kehitys antaa oman näkökulman dokumentaation merkitykselle. Tällä pro gradu -tutkimuksella pyrittiin etsimään vastauksia siihen, mikä on Kanta-palveluiden arkkitehtuurin dokumentaation nykytila, millaiselle arkkitehtuurin dokumentaatiolle on tarvetta ja miten arkkitehtuuria tulisi mallintaa, jotta se voisi palvella mahdollisimman laajaa joukkoa henkilöstöstä yli organisaatiorajojen. Tutkimuksen empiirinen osuus toteutettiin teemahaastatteluilla, johon osallistui 13 asiantuntijaa Kanta-palveluista. Tutkimuksen motivaationa oli tutkijan oma mielenkiinto arkkitehtuurin dokumentaatioon sekä tarve kehittää dokumentaatiota Kanta-palveluissa. Tutkimustulokset analysoitiin sisällönanalyysillä. Teemahaastatteluiden perusteella havaittiin, että dokumentaatio on kirjavaa ja ne ovat hajautuneet moneen eri paikkaan. Tämä johtaa siihen, että dokumentaatiot eivät ole ajan tasalla tai helposti löydettävissä. Puutteellisesta dokumentaatiosta on enemmän haittaa kuin hyötyä. Dokumentaation merkitys myös korostui sidosryhmien välisessä kommunikaatiossa ja yhteisten mallien puutteena. Haasteet johtavat siihen, että dokumentaatiota ei tuoteta kirjoitettuun muotoon riittävällä tavalla tai dokumentaatio jopa sivuutetaan ja tehdään, kun siihen on aikaa. Haasteet voidaan voittaa sillä, että dokumentaatio on osa jatkuvaa kehittämistä ja siihen on varattu riittävästi aikaa. Kehityksessä täytyy ottaa selkeitä askeleita dokumentaation selkeyttämiseen kehityksen alkuvaiheesta asti. Tähän voi auttaa myös työpajojen järjestäminen aiheen tiimoilta. Ohjeistusta täytyy päivittää ja työkaluja ottaa käyttöön aktiivisemmin. In information system development, the documentation of architecture is of the great importance. The importance is emphasized at different stages of development, both in the orientation of a new employee and in the maintenance when dealing with the issue from the production. In the literature, the importance of documentation is especially emphasized when the documentation is not up-to-date or easy to find and in communication between stakeholders. Agile development also gives its own perspective on the importance of documentation. The aim of this master's study was to find answers to the current state of the architecture documentation for Kanta services, what kind of architectural documentation is needed and how the architecture should be modeled in order to serve the widest possible number of personnel across organizational boundaries. The empirical part of the study was carried out through thematic interviews with 13 experts from Kanta services. The motivation for the research was the researcher's own interest in the documentation of architecture and the need to develop documentation in Kanta services. The study results were analyzed by content analysis. Based on the thematic interviews, it was found that the documentation is diverse and scattered in many different places. This results in the documentation not being up-to-date or easy to find. Incomplete documentation does more harm than good. The importance of documentation was also emphasized in the communication between stakeholders and in the absence of common models. Challenges result in the documentation not being produced in a written form adequately, or the documentation is even ignored and done when time allows. Challenges can be overcome by ensuring that documentation is part of continuous development and that sufficient time is set aside for it. Clear steps must be taken early on in the development to clarify the documentation. Organizing workshops on the topic can also help with this. The instructions need to be updated and the tools must be taken into use more actively.
first_indexed 2024-09-11T08:50:03Z
format Pro gradu
free_online_boolean 1
fullrecord [{"key": "dc.contributor.advisor", "value": "Halttunen, Veikko", "language": "", "element": "contributor", "qualifier": "advisor", "schema": "dc"}, {"key": "dc.contributor.author", "value": "Mankonen, Tiina", "language": "", "element": "contributor", "qualifier": "author", "schema": "dc"}, {"key": "dc.date.accessioned", "value": "2022-07-01T08:36:49Z", "language": null, "element": "date", "qualifier": "accessioned", "schema": "dc"}, {"key": "dc.date.available", "value": "2022-07-01T08:36:49Z", "language": null, "element": "date", "qualifier": "available", "schema": "dc"}, {"key": "dc.date.issued", "value": "2022", "language": "", "element": "date", "qualifier": "issued", "schema": "dc"}, {"key": "dc.identifier.uri", "value": "https://jyx.jyu.fi/handle/123456789/82157", "language": null, "element": "identifier", "qualifier": "uri", "schema": "dc"}, {"key": "dc.description.abstract", "value": "Tietoj\u00e4rjestelm\u00e4kehityksess\u00e4 arkkitehtuurin dokumentoinnilla on suuri merkitys. Merkitys korostuu kehityksen eri vaiheissa, niin uuden ty\u00f6ntekij\u00e4n perehdytyksess\u00e4 kuin yll\u00e4pidossa tuotannon ongelman selvittelyss\u00e4. Alan kirjallisuudessa dokumentaation merkitys korostuu erityisesti, kun dokumentaatio ei ole ajan tasalla tai helposti l\u00f6ydett\u00e4viss\u00e4 ja sidosryhmien v\u00e4lisess\u00e4 kommunikaatiossa. My\u00f6s ketter\u00e4 kehitys antaa oman n\u00e4k\u00f6kulman dokumentaation merkitykselle. T\u00e4ll\u00e4 pro gradu -tutkimuksella pyrittiin etsim\u00e4\u00e4n vastauksia siihen, mik\u00e4 on Kanta-palveluiden arkkitehtuurin dokumentaation nykytila, millaiselle arkkitehtuurin dokumentaatiolle on tarvetta ja miten arkkitehtuuria tulisi mallintaa, jotta se voisi palvella mahdollisimman laajaa joukkoa henkil\u00f6st\u00f6st\u00e4 yli organisaatiorajojen. Tutkimuksen empiirinen osuus toteutettiin teemahaastatteluilla, johon osallistui 13 asiantuntijaa Kanta-palveluista. Tutkimuksen motivaationa oli tutkijan oma mielenkiinto arkkitehtuurin dokumentaatioon sek\u00e4 tarve kehitt\u00e4\u00e4 dokumentaatiota Kanta-palveluissa. Tutkimustulokset analysoitiin sis\u00e4ll\u00f6nanalyysill\u00e4. Teemahaastatteluiden perusteella havaittiin, ett\u00e4 dokumentaatio on kirjavaa ja ne ovat hajautuneet moneen eri paikkaan. T\u00e4m\u00e4 johtaa siihen, ett\u00e4 dokumentaatiot eiv\u00e4t ole ajan tasalla tai helposti l\u00f6ydett\u00e4viss\u00e4. Puutteellisesta dokumentaatiosta on enemm\u00e4n haittaa kuin hy\u00f6ty\u00e4. Dokumentaation merkitys my\u00f6s korostui sidosryhmien v\u00e4lisess\u00e4 kommunikaatiossa ja yhteisten mallien puutteena. Haasteet johtavat siihen, ett\u00e4 dokumentaatiota ei tuoteta kirjoitettuun muotoon riitt\u00e4v\u00e4ll\u00e4 tavalla tai dokumentaatio jopa sivuutetaan ja tehd\u00e4\u00e4n, kun siihen on aikaa. Haasteet voidaan voittaa sill\u00e4, ett\u00e4 dokumentaatio on osa jatkuvaa kehitt\u00e4mist\u00e4 ja siihen on varattu riitt\u00e4v\u00e4sti aikaa. Kehityksess\u00e4 t\u00e4ytyy ottaa selkeit\u00e4 askeleita dokumentaation selkeytt\u00e4miseen kehityksen alkuvaiheesta asti. T\u00e4h\u00e4n voi auttaa my\u00f6s ty\u00f6pajojen j\u00e4rjest\u00e4minen aiheen tiimoilta. Ohjeistusta t\u00e4ytyy p\u00e4ivitt\u00e4\u00e4 ja ty\u00f6kaluja ottaa k\u00e4ytt\u00f6\u00f6n aktiivisemmin.", "language": "fi", "element": "description", "qualifier": "abstract", "schema": "dc"}, {"key": "dc.description.abstract", "value": "In information system development, the documentation of architecture is of the great importance. The importance is emphasized at different stages of development, both in the orientation of a new employee and in the maintenance when dealing with the issue from the production. In the literature, the importance of documentation is especially emphasized when the documentation is not up-to-date or easy to find and in communication between stakeholders. Agile development also gives its own perspective on the importance of documentation. The aim of this master's study was to find answers to the current state of the architecture documentation for Kanta services, what kind of architectural documentation is needed and how the architecture should be modeled in order to serve the widest possible number of personnel across organizational boundaries. The empirical part of the study was carried out through thematic interviews with 13 experts from Kanta services. The motivation for the research was the researcher's own interest in the documentation of architecture and the need to develop documentation in Kanta services. The study results were analyzed by content analysis. Based on the thematic interviews, it was found that the documentation is diverse and scattered in many different places. This results in the documentation not being up-to-date or easy to find. Incomplete documentation does more harm than good. The importance of documentation was also emphasized in the communication between stakeholders and in the absence of common models. Challenges result in the documentation not being produced in a written form adequately, or the documentation is even ignored and done when time allows. Challenges can be overcome by ensuring that documentation is part of continuous development and that sufficient time is set aside for it. Clear steps must be taken early on in the development to clarify the documentation. Organizing workshops on the topic can also help with this. The instructions need to be updated and the tools must be taken into use more actively.", "language": "en", "element": "description", "qualifier": "abstract", "schema": "dc"}, {"key": "dc.description.provenance", "value": "Submitted by Miia Hakanen (mihakane@jyu.fi) on 2022-07-01T08:36:49Z\nNo. of bitstreams: 0", "language": "en", "element": "description", "qualifier": "provenance", "schema": "dc"}, {"key": "dc.description.provenance", "value": "Made available in DSpace on 2022-07-01T08:36:49Z (GMT). No. of bitstreams: 0\n Previous issue date: 2022", "language": "en", "element": "description", "qualifier": "provenance", "schema": "dc"}, {"key": "dc.format.extent", "value": "72", "language": "", "element": "format", "qualifier": "extent", "schema": "dc"}, {"key": "dc.format.mimetype", "value": "application/pdf", "language": null, "element": "format", "qualifier": "mimetype", "schema": "dc"}, {"key": "dc.language.iso", "value": "fin", "language": null, "element": "language", "qualifier": "iso", "schema": "dc"}, {"key": "dc.rights", "value": "In Copyright", "language": "en", "element": "rights", "qualifier": null, "schema": "dc"}, {"key": "dc.subject.other", "value": "arkkitehtuurin dokumentointi", "language": "", "element": "subject", "qualifier": "other", "schema": "dc"}, {"key": "dc.subject.other", "value": "kommunikaatio", "language": "", "element": "subject", "qualifier": "other", "schema": "dc"}, {"key": "dc.title", "value": "Arkkitehtuurin dokumentointi kehitt\u00e4j\u00e4n ja yll\u00e4pidon n\u00e4k\u00f6kulmasta : case: Kanta-palvelut", "language": "", "element": "title", "qualifier": null, "schema": "dc"}, {"key": "dc.type", "value": "master thesis", "language": null, "element": "type", "qualifier": null, "schema": "dc"}, {"key": "dc.identifier.urn", "value": "URN:NBN:fi:jyu-202207013759", "language": "", "element": "identifier", "qualifier": "urn", "schema": "dc"}, {"key": "dc.type.ontasot", "value": "Pro gradu -tutkielma", "language": "fi", "element": "type", "qualifier": "ontasot", "schema": "dc"}, {"key": "dc.type.ontasot", "value": "Master\u2019s thesis", "language": "en", "element": "type", "qualifier": "ontasot", "schema": "dc"}, {"key": "dc.contributor.faculty", "value": "Informaatioteknologian tiedekunta", "language": "fi", "element": "contributor", "qualifier": "faculty", "schema": "dc"}, {"key": "dc.contributor.faculty", "value": "Faculty of Information Technology", "language": "en", "element": "contributor", "qualifier": "faculty", "schema": "dc"}, {"key": "dc.contributor.department", "value": "Informaatioteknologia", "language": "fi", "element": "contributor", "qualifier": "department", "schema": "dc"}, {"key": "dc.contributor.department", "value": "Information Technology", "language": "en", "element": "contributor", "qualifier": "department", "schema": "dc"}, {"key": "dc.contributor.organization", "value": "Jyv\u00e4skyl\u00e4n yliopisto", "language": "fi", "element": "contributor", "qualifier": "organization", "schema": "dc"}, {"key": "dc.contributor.organization", "value": "University of Jyv\u00e4skyl\u00e4", "language": "en", "element": "contributor", "qualifier": "organization", "schema": "dc"}, {"key": "dc.subject.discipline", "value": "Tietoj\u00e4rjestelm\u00e4tiede", "language": "fi", "element": "subject", "qualifier": "discipline", "schema": "dc"}, {"key": "dc.subject.discipline", "value": "Information Systems Science", "language": "en", "element": "subject", "qualifier": "discipline", "schema": "dc"}, {"key": "yvv.contractresearch.collaborator", "value": "public", "language": "", "element": "contractresearch", "qualifier": "collaborator", "schema": "yvv"}, {"key": "yvv.contractresearch.funding", "value": "0", "language": "", "element": "contractresearch", "qualifier": "funding", "schema": "yvv"}, {"key": "yvv.contractresearch.initiative", "value": "student", "language": "", "element": "contractresearch", "qualifier": "initiative", "schema": "yvv"}, {"key": "dc.type.coar", "value": "http://purl.org/coar/resource_type/c_bdcc", "language": null, "element": "type", "qualifier": "coar", "schema": "dc"}, {"key": "dc.rights.accesslevel", "value": "openAccess", "language": null, "element": "rights", "qualifier": "accesslevel", "schema": "dc"}, {"key": "dc.type.publication", "value": "masterThesis", "language": null, "element": "type", "qualifier": "publication", "schema": "dc"}, {"key": "dc.subject.oppiainekoodi", "value": "601", "language": "", "element": "subject", "qualifier": "oppiainekoodi", "schema": "dc"}, {"key": "dc.subject.yso", "value": "dokumentointi", "language": null, "element": "subject", "qualifier": "yso", "schema": "dc"}, {"key": "dc.subject.yso", "value": "ohjelmistoarkkitehtuuri", "language": null, "element": "subject", "qualifier": "yso", "schema": "dc"}, {"key": "dc.format.content", "value": "fulltext", "language": null, "element": "format", "qualifier": "content", "schema": "dc"}, {"key": "dc.rights.url", "value": "https://rightsstatements.org/page/InC/1.0/", "language": null, "element": "rights", "qualifier": "url", "schema": "dc"}, {"key": "dc.type.okm", "value": "G2", "language": null, "element": "type", "qualifier": "okm", "schema": "dc"}]
id jyx.123456789_82157
language fin
last_indexed 2025-03-31T20:03:01Z
main_date 2022-01-01T00:00:00Z
main_date_str 2022
online_boolean 1
online_urls_str_mv {"url":"https:\/\/jyx.jyu.fi\/bitstreams\/b5f7b991-6c1a-4f21-ab9f-fc0b87beb024\/download","text":"URN:NBN:fi:jyu-202207013759.pdf","source":"jyx","mediaType":"application\/pdf"}
publishDate 2022
record_format qdc
source_str_mv jyx
spellingShingle Mankonen, Tiina Arkkitehtuurin dokumentointi kehittäjän ja ylläpidon näkökulmasta : case: Kanta-palvelut arkkitehtuurin dokumentointi kommunikaatio Tietojärjestelmätiede Information Systems Science 601 dokumentointi ohjelmistoarkkitehtuuri
title Arkkitehtuurin dokumentointi kehittäjän ja ylläpidon näkökulmasta : case: Kanta-palvelut
title_full Arkkitehtuurin dokumentointi kehittäjän ja ylläpidon näkökulmasta : case: Kanta-palvelut
title_fullStr Arkkitehtuurin dokumentointi kehittäjän ja ylläpidon näkökulmasta : case: Kanta-palvelut Arkkitehtuurin dokumentointi kehittäjän ja ylläpidon näkökulmasta : case: Kanta-palvelut
title_full_unstemmed Arkkitehtuurin dokumentointi kehittäjän ja ylläpidon näkökulmasta : case: Kanta-palvelut Arkkitehtuurin dokumentointi kehittäjän ja ylläpidon näkökulmasta : case: Kanta-palvelut
title_short Arkkitehtuurin dokumentointi kehittäjän ja ylläpidon näkökulmasta
title_sort arkkitehtuurin dokumentointi kehittäjän ja ylläpidon näkökulmasta case kanta palvelut
title_sub case: Kanta-palvelut
title_txtP Arkkitehtuurin dokumentointi kehittäjän ja ylläpidon näkökulmasta : case: Kanta-palvelut
topic arkkitehtuurin dokumentointi kommunikaatio Tietojärjestelmätiede Information Systems Science 601 dokumentointi ohjelmistoarkkitehtuuri
topic_facet 601 Information Systems Science Tietojärjestelmätiede arkkitehtuurin dokumentointi dokumentointi kommunikaatio ohjelmistoarkkitehtuuri
url https://jyx.jyu.fi/handle/123456789/82157 http://www.urn.fi/URN:NBN:fi:jyu-202207013759
work_keys_str_mv AT mankonentiina arkkitehtuurindokumentointikehittäjänjaylläpidonnäkökulmastacasekantapalvelut