Evaluating and revising user documentation following minimalism heuristics a case study

Käyttäjien on nykyaikana pystyttävä hallitsemaan yhä kasvavaa määrää teknologioita. Jotta uusien teknologioiden ja niiden ominaisuuksien omaksuminen olisi helpompaa, laadukas käyttäjädokumentaatio on tärkeää. Käyttäjädokumentaation merkityksen kasvaessa on syntynyt tarve kehittää entistä käyttäjäläh...

Full description

Bibliographic Details
Main Author: Kylliäinen, Jenni
Other Authors: Humanistis-yhteiskuntatieteellinen tiedekunta, Faculty of Humanities and Social Sciences, Kieli- ja viestintätieteiden laitos, Department of Language and Communication Studies, Jyväskylän yliopisto, University of Jyväskylä
Format: Master's thesis
Language:eng
Published: 2025
Subjects:
Online Access: https://jyx.jyu.fi/handle/123456789/103485
_version_ 1834856795917516800
author Kylliäinen, Jenni
author2 Humanistis-yhteiskuntatieteellinen tiedekunta Faculty of Humanities and Social Sciences Kieli- ja viestintätieteiden laitos Department of Language and Communication Studies Jyväskylän yliopisto University of Jyväskylä
author_facet Kylliäinen, Jenni Humanistis-yhteiskuntatieteellinen tiedekunta Faculty of Humanities and Social Sciences Kieli- ja viestintätieteiden laitos Department of Language and Communication Studies Jyväskylän yliopisto University of Jyväskylä Kylliäinen, Jenni Humanistis-yhteiskuntatieteellinen tiedekunta Faculty of Humanities and Social Sciences Kieli- ja viestintätieteiden laitos Department of Language and Communication Studies Jyväskylän yliopisto University of Jyväskylä
author_sort Kylliäinen, Jenni
datasource_str_mv jyx
description Käyttäjien on nykyaikana pystyttävä hallitsemaan yhä kasvavaa määrää teknologioita. Jotta uusien teknologioiden ja niiden ominaisuuksien omaksuminen olisi helpompaa, laadukas käyttäjädokumentaatio on tärkeää. Käyttäjädokumentaation merkityksen kasvaessa on syntynyt tarve kehittää entistä käyttäjälähtöisempiä ja selkeämpiä dokumentaation tuottamisen malleja. Yksi tällainen lähestymistapa on John M. Carrollin (1990) kehittämä minimalismi, joka korostaa käyttäjälähtöistä ja toimintaorientoitunutta ohjeistusta. Tässä tutkielmassa tarkastellaan minimalismin soveltamista käyttäjädokumentaation arvioinnissa ja kehittämisessä Virtaluodon, Suojasen ja Isohellan (2021) minimalismin heuristiikkojen avulla. Tutkimuksessa arvioitiin ja päivitettiin Citynomadi Oy:n tarjoaman Citynomadi Tuner 2.0 -palvelun käyttöohjeet Virtaluodon, Suojasen ja Isohellan (2021) heuristiikkojen perusteella. Tutkimuksen tarkoituksena oli arvioida, miten näiden heuristiikkojen hyödyntäminen tukee kokematonta teknistä kirjoittajaa minimalistisen dokumentaatioprosessin aikana. Arvioinnin tuloksena havaittiin, että vaikka alkuperäinen dokumentaatio sisälsi minimalismin periaatteita noudattavia piirteitä, muutoksia tulisi kuitenkin tehdä erityisesti siihen muotoon, missä ohjeistukset ja virheinformaatio esitetään. Tutkimuksen tulokset osoittivat, että heuristiikat tukivat kokematonta teknistä kirjoittajaa arviointi- ja päivitysprosessissa. Heuristiikkojen selkeä rakenne ja konkreettiset esimerkit helpottivat dokumentaation kehittämistä ja lisäsivät varmuutta merkittävämpienkin muutosten tekemiseen. Tutkimus osoittaa, että myös pienemmissä organisaatioissa, joissa resurssit ovat rajalliset, voidaan hyödyntää minimalismia dokumentaation kehittämisessä. Tutkimuksen merkitystä voitaisiin vahvistaa tulevaisuudessa keräämällä käyttäjäpalautetta päivitetyistä ohjeista sekä osallistamalla useampia arvioijia dokumentaatioprosessiin.
first_indexed 2025-06-12T20:00:51Z
format Pro gradu
free_online_boolean 1
fullrecord [{"key": "dc.contributor.advisor", "value": "Kyt\u00f6l\u00e4, Samu", "language": null, "element": "contributor", "qualifier": "advisor", "schema": "dc"}, {"key": "dc.contributor.author", "value": "Kylli\u00e4inen, Jenni", "language": null, "element": "contributor", "qualifier": "author", "schema": "dc"}, {"key": "dc.date.accessioned", "value": "2025-06-12T10:05:40Z", "language": null, "element": "date", "qualifier": "accessioned", "schema": "dc"}, {"key": "dc.date.available", "value": "2025-06-12T10:05:40Z", "language": null, "element": "date", "qualifier": "available", "schema": "dc"}, {"key": "dc.date.issued", "value": "2025", "language": null, "element": "date", "qualifier": "issued", "schema": "dc"}, {"key": "dc.identifier.uri", "value": "https://jyx.jyu.fi/handle/123456789/103485", "language": null, "element": "identifier", "qualifier": "uri", "schema": "dc"}, {"key": "dc.description.abstract", "value": "K\u00e4ytt\u00e4jien on nykyaikana pystytt\u00e4v\u00e4 hallitsemaan yh\u00e4 kasvavaa m\u00e4\u00e4r\u00e4\u00e4 teknologioita. Jotta uusien teknologioiden ja niiden ominaisuuksien omaksuminen olisi helpompaa, laadukas k\u00e4ytt\u00e4j\u00e4dokumentaatio on t\u00e4rke\u00e4\u00e4. K\u00e4ytt\u00e4j\u00e4dokumentaation merkityksen kasvaessa on syntynyt tarve kehitt\u00e4\u00e4 entist\u00e4 k\u00e4ytt\u00e4j\u00e4l\u00e4ht\u00f6isempi\u00e4 ja selke\u00e4mpi\u00e4 dokumentaation tuottamisen malleja. Yksi t\u00e4llainen l\u00e4hestymistapa on John M. Carrollin (1990) kehitt\u00e4m\u00e4 minimalismi, joka korostaa k\u00e4ytt\u00e4j\u00e4l\u00e4ht\u00f6ist\u00e4 ja toimintaorientoitunutta ohjeistusta. T\u00e4ss\u00e4 tutkielmassa tarkastellaan minimalismin soveltamista k\u00e4ytt\u00e4j\u00e4dokumentaation arvioinnissa ja kehitt\u00e4misess\u00e4 Virtaluodon, Suojasen ja Isohellan (2021) minimalismin heuristiikkojen avulla.\nTutkimuksessa arvioitiin ja p\u00e4ivitettiin Citynomadi Oy:n tarjoaman Citynomadi Tuner 2.0 -palvelun k\u00e4ytt\u00f6ohjeet Virtaluodon, Suojasen ja Isohellan (2021) heuristiikkojen perusteella. Tutkimuksen tarkoituksena oli arvioida, miten n\u00e4iden heuristiikkojen hy\u00f6dynt\u00e4minen tukee kokematonta teknist\u00e4 kirjoittajaa minimalistisen dokumentaatioprosessin aikana. Arvioinnin tuloksena havaittiin, ett\u00e4 vaikka alkuper\u00e4inen dokumentaatio sis\u00e4lsi minimalismin periaatteita noudattavia piirteit\u00e4, muutoksia tulisi kuitenkin tehd\u00e4 erityisesti siihen muotoon, miss\u00e4 ohjeistukset ja virheinformaatio esitet\u00e4\u00e4n. \nTutkimuksen tulokset osoittivat, ett\u00e4 heuristiikat tukivat kokematonta teknist\u00e4 kirjoittajaa arviointi- ja p\u00e4ivitysprosessissa. Heuristiikkojen selke\u00e4 rakenne ja konkreettiset esimerkit helpottivat dokumentaation kehitt\u00e4mist\u00e4 ja lis\u00e4siv\u00e4t varmuutta merkitt\u00e4v\u00e4mpienkin muutosten tekemiseen. Tutkimus osoittaa, ett\u00e4 my\u00f6s pienemmiss\u00e4 organisaatioissa, joissa resurssit ovat rajalliset, voidaan hy\u00f6dynt\u00e4\u00e4 minimalismia dokumentaation kehitt\u00e4misess\u00e4. Tutkimuksen merkityst\u00e4 voitaisiin vahvistaa tulevaisuudessa ker\u00e4\u00e4m\u00e4ll\u00e4 k\u00e4ytt\u00e4j\u00e4palautetta p\u00e4ivitetyist\u00e4 ohjeista sek\u00e4 osallistamalla useampia arvioijia dokumentaatioprosessiin.", "language": "fi", "element": "description", "qualifier": "abstract", "schema": "dc"}, {"key": "dc.description.abstract", "value": "", "language": "en", "element": "description", "qualifier": "abstract", "schema": "dc"}, {"key": "dc.description.provenance", "value": "Submitted by Paivi Vuorio (paelvuor@jyu.fi) on 2025-06-12T10:05:40Z\nNo. of bitstreams: 0", "language": "en", "element": "description", "qualifier": "provenance", "schema": "dc"}, {"key": "dc.description.provenance", "value": "Made available in DSpace on 2025-06-12T10:05:40Z (GMT). No. of bitstreams: 0\n Previous issue date: 2025", "language": "en", "element": "description", "qualifier": "provenance", "schema": "dc"}, {"key": "dc.format.extent", "value": "53", "language": null, "element": "format", "qualifier": "extent", "schema": "dc"}, {"key": "dc.language.iso", "value": "eng", "language": null, "element": "language", "qualifier": "iso", "schema": "dc"}, {"key": "dc.rights", "value": "In Copyright", "language": null, "element": "rights", "qualifier": null, "schema": "dc"}, {"key": "dc.subject.other", "value": "heuristic evaluation", "language": null, "element": "subject", "qualifier": "other", "schema": "dc"}, {"key": "dc.subject.other", "value": "user documentation", "language": null, "element": "subject", "qualifier": "other", "schema": "dc"}, {"key": "dc.subject.other", "value": "heuristinen arviointi", "language": null, "element": "subject", "qualifier": "other", "schema": "dc"}, {"key": "dc.subject.other", "value": "k\u00e4ytt\u00e4j\u00e4dokumentaatio", "language": null, "element": "subject", "qualifier": "other", "schema": "dc"}, {"key": "dc.title", "value": "Evaluating and revising user documentation following minimalism heuristics : a case study", "language": null, "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-202506125301", "language": null, "element": "identifier", "qualifier": "urn", "schema": "dc"}, {"key": "dc.contributor.faculty", "value": "Humanistis-yhteiskuntatieteellinen tiedekunta", "language": "fi", "element": "contributor", "qualifier": "faculty", "schema": "dc"}, {"key": "dc.contributor.faculty", "value": "Faculty of Humanities and Social Sciences", "language": "en", "element": "contributor", "qualifier": "faculty", "schema": "dc"}, {"key": "dc.contributor.department", "value": "Kieli- ja viestint\u00e4tieteiden laitos", "language": "fi", "element": "contributor", "qualifier": "department", "schema": "dc"}, {"key": "dc.contributor.department", "value": "Department of Language and Communication Studies", "language": "en", "element": "contributor", "qualifier": "department", "schema": "dc"}, {"key": "dc.contributor.organization", "value": "Jyv\u00e4skyl\u00e4n yliopisto", "language": null, "element": "contributor", "qualifier": "organization", "schema": "dc"}, {"key": "dc.contributor.organization", "value": "University of Jyv\u00e4skyl\u00e4", "language": null, "element": "contributor", "qualifier": "organization", "schema": "dc"}, {"key": "dc.subject.discipline", "value": "Englannin kieli", "language": "fi", "element": "subject", "qualifier": "discipline", "schema": "dc"}, {"key": "dc.subject.discipline", "value": "English", "language": "en", "element": "subject", "qualifier": "discipline", "schema": "dc"}, {"key": "dc.type.coar", "value": "http://purl.org/coar/resource_type/c_bdcc", "language": null, "element": "type", "qualifier": "coar", "schema": "dc"}, {"key": "dc.rights.copyright", "value": "\u00a9 The Author(s)", "language": "fi", "element": "rights", "qualifier": "copyright", "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.yso", "value": "minimalismi", "language": null, "element": "subject", "qualifier": "yso", "schema": "dc"}, {"key": "dc.subject.yso", "value": "dokumentointi", "language": null, "element": "subject", "qualifier": "yso", "schema": "dc"}, {"key": "dc.subject.yso", "value": "k\u00e4ytt\u00e4j\u00e4t", "language": null, "element": "subject", "qualifier": "yso", "schema": "dc"}, {"key": "dc.subject.yso", "value": "arviointi", "language": null, "element": "subject", "qualifier": "yso", "schema": "dc"}, {"key": "dc.subject.yso", "value": "k\u00e4ytt\u00e4j\u00e4l\u00e4ht\u00f6isyys", "language": null, "element": "subject", "qualifier": "yso", "schema": "dc"}, {"key": "dc.subject.yso", "value": "heuristiikka", "language": null, "element": "subject", "qualifier": "yso", "schema": "dc"}, {"key": "dc.subject.yso", "value": "k\u00e4ytett\u00e4vyys", "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_103485
language eng
last_indexed 2025-06-12T20:00:51Z
main_date 2025-01-01T00:00:00Z
main_date_str 2025
online_boolean 1
online_urls_str_mv {"url":"https:\/\/jyx.jyu.fi\/bitstreams\/63713360-8f7c-4696-85c4-c5e9f51d008a\/download","text":"URN:NBN:fi:jyu-202506125301.pdf","source":"jyx","mediaType":"application\/pdf"}
publishDate 2025
record_format qdc
source_str_mv jyx
spellingShingle Kylliäinen, Jenni Evaluating and revising user documentation following minimalism heuristics : a case study heuristic evaluation user documentation heuristinen arviointi käyttäjädokumentaatio Englannin kieli English minimalismi dokumentointi käyttäjät arviointi käyttäjälähtöisyys heuristiikka käytettävyys
title Evaluating and revising user documentation following minimalism heuristics : a case study
title_full Evaluating and revising user documentation following minimalism heuristics : a case study
title_fullStr Evaluating and revising user documentation following minimalism heuristics : a case study Evaluating and revising user documentation following minimalism heuristics : a case study
title_full_unstemmed Evaluating and revising user documentation following minimalism heuristics : a case study Evaluating and revising user documentation following minimalism heuristics : a case study
title_short Evaluating and revising user documentation following minimalism heuristics
title_sort evaluating and revising user documentation following minimalism heuristics a case study
title_sub a case study
title_txtP Evaluating and revising user documentation following minimalism heuristics : a case study
topic heuristic evaluation user documentation heuristinen arviointi käyttäjädokumentaatio Englannin kieli English minimalismi dokumentointi käyttäjät arviointi käyttäjälähtöisyys heuristiikka käytettävyys
topic_facet Englannin kieli English arviointi dokumentointi heuristic evaluation heuristiikka heuristinen arviointi käytettävyys käyttäjädokumentaatio käyttäjälähtöisyys käyttäjät minimalismi user documentation
url https://jyx.jyu.fi/handle/123456789/103485 http://www.urn.fi/URN:NBN:fi:jyu-202506125301
work_keys_str_mv AT kylliäinenjenni evaluatingandrevisinguserdocumentationfollowingminimalismheuristicsacasestudy