Dokumentaatio ketterässä kehityksessä ja siihen liittyvät käytänteet ja työkalut

Hyvä dokumentaatio selkeyttää ohjelmiston tavoitteita, auttaa uusien kehittäjien perehdyttämisessä ja parantaa viestintää ketterissä kehitystiimeissä. Vaikka yksi ketterän ohjelmistokehityksen julistuksen pääperiaatteista on asettaa toimiva ohjelmisto kattavan dokumentaation edelle, tehokkaalla doku...

Full description

Bibliographic Details
Main Author: Tammi, Pekka
Other Authors: Informaatioteknologian tiedekunta, Faculty of Information Technology, Informaatioteknologia, Information Technology, Jyväskylän yliopisto, University of Jyväskylä
Format: Bachelor's thesis
Language:fin
Published: 2024
Subjects:
Online Access: https://jyx.jyu.fi/handle/123456789/95090
_version_ 1826225812629618688
author Tammi, Pekka
author2 Informaatioteknologian tiedekunta Faculty of Information Technology Informaatioteknologia Information Technology Jyväskylän yliopisto University of Jyväskylä
author_facet Tammi, Pekka Informaatioteknologian tiedekunta Faculty of Information Technology Informaatioteknologia Information Technology Jyväskylän yliopisto University of Jyväskylä Tammi, Pekka Informaatioteknologian tiedekunta Faculty of Information Technology Informaatioteknologia Information Technology Jyväskylän yliopisto University of Jyväskylä
author_sort Tammi, Pekka
datasource_str_mv jyx
description Hyvä dokumentaatio selkeyttää ohjelmiston tavoitteita, auttaa uusien kehittäjien perehdyttämisessä ja parantaa viestintää ketterissä kehitystiimeissä. Vaikka yksi ketterän ohjelmistokehityksen julistuksen pääperiaatteista on asettaa toimiva ohjelmisto kattavan dokumentaation edelle, tehokkaalla dokumentaatiolla on silti tärkeä rooli. Tutkielma keskittyy siihen, mitä nykyaikaisesta ohjelmistosta dokumentoidaan. Tyypillisesti dokumentoitavat osat, kuten käyttäjätarinat, toiminnalliset ja ei-toiminnalliset vaatimukset. Nämä auttavat kehittäjiä ymmärtämään ja hallitsemaan projektin laajuutta ja vaatimuksia. Lisäksi tässä tutkimuksessa tarkastellaan työkaluja, kuten wikejä, jotka tukevat kehittäjiä dokumentaation ylläpidossa ja kirjoittamisessa. Nämä työkalut mahdollistavat kehittäjille dokumentaation yhteisöllisen ja iteratiivisen kirjoittamisen, säästäen aikaa ja parantaen yhteistyötä ketterissä tiimeissä. Tutkimus nostaa esiin kysymyksen siitä, miksi dokumentaation laatiminen on usein välteltävä tehtävä ketterien ohjelmistokehittäjien keskuudessa sekä näennäistä ristiriitaa, jossa kehittäjät tunnustavat silti tehokkaan dokumentaation tärkeyden työssään. Documentation in agile software development is a frequently discussed topic. Although one of the main principles of agile software development is to prioritize working software over comprehensive documentation, effective documentation still plays an important role. Effective documentation clarifies the software’s goals, helps in the onboarding of new developers, and improves communication within agile development teams. The thesis focuses on various aspects of documentation in modern software. It consists of multiple different elements. These elements, such as user stories, functional and nonfunctional requirements, assist developers in understanding and managing the project’s scope and specifications. Additionally, this study examines tools, e.g. wikis, that support developers in maintaining and writing documentation. These tools enable developers to collaboratively and iteratively write documentation, saving time and enhancing synergy within agile teams. This study raises the question of why documentation is often viewed as a dreaded task among agile software developers. It also explores the apparent contradiction where developers still recognize the importance of effective documentation in their work.
first_indexed 2024-05-23T20:01:03Z
format Kandityö
free_online_boolean 1
fullrecord [{"key": "dc.contributor.advisor", "value": "Lakanen, Antti-Jussi", "language": "", "element": "contributor", "qualifier": "advisor", "schema": "dc"}, {"key": "dc.contributor.author", "value": "Tammi, Pekka", "language": "", "element": "contributor", "qualifier": "author", "schema": "dc"}, {"key": "dc.date.accessioned", "value": "2024-05-23T05:53:49Z", "language": null, "element": "date", "qualifier": "accessioned", "schema": "dc"}, {"key": "dc.date.available", "value": "2024-05-23T05:53:49Z", "language": null, "element": "date", "qualifier": "available", "schema": "dc"}, {"key": "dc.date.issued", "value": "2024", "language": "", "element": "date", "qualifier": "issued", "schema": "dc"}, {"key": "dc.identifier.uri", "value": "https://jyx.jyu.fi/handle/123456789/95090", "language": null, "element": "identifier", "qualifier": "uri", "schema": "dc"}, {"key": "dc.description.abstract", "value": "Hyv\u00e4 dokumentaatio selkeytt\u00e4\u00e4 ohjelmiston tavoitteita, auttaa uusien kehitt\u00e4jien perehdytt\u00e4misess\u00e4 ja parantaa viestint\u00e4\u00e4 ketteriss\u00e4 kehitystiimeiss\u00e4. Vaikka yksi ketter\u00e4n ohjelmistokehityksen julistuksen p\u00e4\u00e4periaatteista on asettaa toimiva ohjelmisto kattavan\ndokumentaation edelle, tehokkaalla dokumentaatiolla on silti t\u00e4rke\u00e4 rooli.\nTutkielma keskittyy siihen, mit\u00e4 nykyaikaisesta ohjelmistosta dokumentoidaan. Tyypillisesti dokumentoitavat osat, kuten k\u00e4ytt\u00e4j\u00e4tarinat, toiminnalliset ja ei-toiminnalliset vaatimukset. N\u00e4m\u00e4 auttavat kehitt\u00e4ji\u00e4 ymm\u00e4rt\u00e4m\u00e4\u00e4n ja hallitsemaan projektin laajuutta ja vaatimuksia. Lis\u00e4ksi t\u00e4ss\u00e4 tutkimuksessa tarkastellaan ty\u00f6kaluja, kuten wikej\u00e4, jotka tukevat kehitt\u00e4ji\u00e4 dokumentaation yll\u00e4pidossa ja kirjoittamisessa. N\u00e4m\u00e4 ty\u00f6kalut mahdollistavat kehitt\u00e4jille\ndokumentaation yhteis\u00f6llisen ja iteratiivisen kirjoittamisen, s\u00e4\u00e4st\u00e4en aikaa ja parantaen yhteisty\u00f6t\u00e4 ketteriss\u00e4 tiimeiss\u00e4.\nTutkimus nostaa esiin kysymyksen siit\u00e4, miksi dokumentaation laatiminen on usein v\u00e4ltelt\u00e4v\u00e4 teht\u00e4v\u00e4 ketterien ohjelmistokehitt\u00e4jien keskuudessa sek\u00e4 n\u00e4enn\u00e4ist\u00e4 ristiriitaa, jossa kehitt\u00e4j\u00e4t tunnustavat silti tehokkaan dokumentaation t\u00e4rkeyden ty\u00f6ss\u00e4\u00e4n.", "language": "fi", "element": "description", "qualifier": "abstract", "schema": "dc"}, {"key": "dc.description.abstract", "value": "Documentation in agile software development is a frequently discussed topic.\nAlthough one of the main principles of agile software development is to prioritize working\nsoftware over comprehensive documentation, effective documentation still plays an important role. Effective documentation clarifies the software\u2019s goals, helps in the onboarding of\nnew developers, and improves communication within agile development teams.\nThe thesis focuses on various aspects of documentation in modern software. It consists\nof multiple different elements. These elements, such as user stories, functional and nonfunctional requirements, assist developers in understanding and managing the project\u2019s scope and specifications. Additionally, this study examines tools, e.g. wikis, that support developers in maintaining and writing documentation. These tools enable developers to collaboratively and iteratively write documentation, saving time and enhancing synergy within agile\nteams.\nThis study raises the question of why documentation is often viewed as a dreaded task among\nagile software developers. It also explores the apparent contradiction where developers still\nrecognize the importance of effective documentation in their work.", "language": "en", "element": "description", "qualifier": "abstract", "schema": "dc"}, {"key": "dc.description.provenance", "value": "Submitted by Paivi Vuorio (paelvuor@jyu.fi) on 2024-05-23T05:53:49Z\nNo. of bitstreams: 0", "language": "en", "element": "description", "qualifier": "provenance", "schema": "dc"}, {"key": "dc.description.provenance", "value": "Made available in DSpace on 2024-05-23T05:53:49Z (GMT). No. of bitstreams: 0\n Previous issue date: 2024", "language": "en", "element": "description", "qualifier": "provenance", "schema": "dc"}, {"key": "dc.format.extent", "value": "20", "language": "", "element": "format", "qualifier": "extent", "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": "dokumentaatioty\u00f6kalut", "language": "", "element": "subject", "qualifier": "other", "schema": "dc"}, {"key": "dc.title", "value": "Dokumentaatio ketter\u00e4ss\u00e4 kehityksess\u00e4 ja siihen liittyv\u00e4t k\u00e4yt\u00e4nteet ja ty\u00f6kalut", "language": "", "element": "title", "qualifier": null, "schema": "dc"}, {"key": "dc.type", "value": "bachelor thesis", "language": null, "element": "type", "qualifier": null, "schema": "dc"}, {"key": "dc.identifier.urn", "value": "URN:NBN:fi:jyu-202405233854", "language": "", "element": "identifier", "qualifier": "urn", "schema": "dc"}, {"key": "dc.type.ontasot", "value": "Bachelor's thesis", "language": "en", "element": "type", "qualifier": "ontasot", "schema": "dc"}, {"key": "dc.type.ontasot", "value": "Kandidaatinty\u00f6", "language": "fi", "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": "Tietotekniikka", "language": "fi", "element": "subject", "qualifier": "discipline", "schema": "dc"}, {"key": "dc.subject.discipline", "value": "Mathematical Information Technology", "language": "en", "element": "subject", "qualifier": "discipline", "schema": "dc"}, {"key": "yvv.contractresearch.funding", "value": "0", "language": "", "element": "contractresearch", "qualifier": "funding", "schema": "yvv"}, {"key": "dc.type.coar", "value": "http://purl.org/coar/resource_type/c_7a1f", "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": "bachelorThesis", "language": null, "element": "type", "qualifier": "publication", "schema": "dc"}, {"key": "dc.subject.oppiainekoodi", "value": "602", "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": "ohjelmistokehitys", "language": null, "element": "subject", "qualifier": "yso", "schema": "dc"}, {"key": "dc.rights.url", "value": "https://rightsstatements.org/page/InC/1.0/", "language": null, "element": "rights", "qualifier": "url", "schema": "dc"}]
id jyx.123456789_95090
language fin
last_indexed 2025-02-18T10:56:07Z
main_date 2024-01-01T00:00:00Z
main_date_str 2024
online_boolean 1
online_urls_str_mv {"url":"https:\/\/jyx.jyu.fi\/bitstreams\/dee81bd2-d415-45be-9ceb-7e5d8b104e58\/download","text":"URN:NBN:fi:jyu-202405233854.pdf","source":"jyx","mediaType":"application\/pdf"}
publishDate 2024
record_format qdc
source_str_mv jyx
spellingShingle Tammi, Pekka Dokumentaatio ketterässä kehityksessä ja siihen liittyvät käytänteet ja työkalut dokumentaatiotyökalut Tietotekniikka Mathematical Information Technology 602 dokumentointi ohjelmistokehitys
title Dokumentaatio ketterässä kehityksessä ja siihen liittyvät käytänteet ja työkalut
title_full Dokumentaatio ketterässä kehityksessä ja siihen liittyvät käytänteet ja työkalut
title_fullStr Dokumentaatio ketterässä kehityksessä ja siihen liittyvät käytänteet ja työkalut Dokumentaatio ketterässä kehityksessä ja siihen liittyvät käytänteet ja työkalut
title_full_unstemmed Dokumentaatio ketterässä kehityksessä ja siihen liittyvät käytänteet ja työkalut Dokumentaatio ketterässä kehityksessä ja siihen liittyvät käytänteet ja työkalut
title_short Dokumentaatio ketterässä kehityksessä ja siihen liittyvät käytänteet ja työkalut
title_sort dokumentaatio ketterässä kehityksessä ja siihen liittyvät käytänteet ja työkalut
title_txtP Dokumentaatio ketterässä kehityksessä ja siihen liittyvät käytänteet ja työkalut
topic dokumentaatiotyökalut Tietotekniikka Mathematical Information Technology 602 dokumentointi ohjelmistokehitys
topic_facet 602 Mathematical Information Technology Tietotekniikka dokumentaatiotyökalut dokumentointi ohjelmistokehitys
url https://jyx.jyu.fi/handle/123456789/95090 http://www.urn.fi/URN:NBN:fi:jyu-202405233854
work_keys_str_mv AT tammipekka dokumentaatioketterässäkehityksessäjasiihenliittyvätkäytänteetjatyökalut