{"id":6784,"date":"2020-03-05T12:54:30","date_gmt":"2020-03-05T10:54:30","guid":{"rendered":"https:\/\/atostek.com\/?p=6784"},"modified":"2020-03-05T13:14:07","modified_gmt":"2020-03-05T11:14:07","slug":"miten-kirjoittaa-kayttajaystavallinen-kayttoohje","status":"publish","type":"post","link":"https:\/\/atostek.com\/miten-kirjoittaa-kayttajaystavallinen-kayttoohje\/","title":{"rendered":"Miten kirjoittaa k\u00e4ytt\u00e4j\u00e4yst\u00e4v\u00e4llinen k\u00e4ytt\u00f6ohje?"},"content":{"rendered":"
Pro gradu -tutkielma \u2022 Kirjoittaja: Heidi Martikainen \u2022 Lue tutkielma<\/a><\/div>\n

K\u00e4ytt\u00f6ohjeiden k\u00e4ytett\u00e4vyydell\u00e4 tarkoitetaan k\u00e4ytt\u00e4j\u00e4n tarvitseman tiedon l\u00f6ytymist\u00e4 helposti lukutottumuksista riippumatta sek\u00e4 sit\u00e4, ett\u00e4 k\u00e4ytt\u00f6ohjeen avulla k\u00e4ytt\u00e4j\u00e4 onnistuu j\u00e4rjestelm\u00e4n k\u00e4ytt\u00f6liittym\u00e4n k\u00e4yt\u00f6ss\u00e4 ja oppii k\u00e4ytt\u00f6liittym\u00e4n k\u00e4ytt\u00f6\u00e4 pidemm\u00e4ll\u00e4 aikav\u00e4lill\u00e4 paremmin kuin h\u00e4n ilman k\u00e4ytt\u00f6ohjetta oppisi. <\/em><\/p>\n

Johdanto<\/h2>\n

Yrityksess\u00e4 kehitett\u00e4v\u00e4lle j\u00e4rjestelm\u00e4lle pit\u00e4isi kirjoittaa k\u00e4ytt\u00f6ohje, mutta kiireess\u00e4 ja paineessa muut asiat priorisoidaan edelle. Jotta lain vaatimukset tai asiakkaan kanssa tehty sopimus voidaan kuitata huomioiduiksi, lopulta se kuuluisa joku<\/em> kasaa k\u00e4ytt\u00f6ohjeen h\u00e4t\u00e4isesti ja toivoo, ettei siihen tarvitse en\u00e4\u00e4 palata. Kuulostaako tutulta?<\/strong> K\u00e4ytt\u00f6ohjeet tuntuvat olevan yleinen tuska niin niiden kirjoittajille kuin lukijoillekin. T\u00e4t\u00e4 perinnett\u00e4 ei kuitenkaan tarvitse jatkaa, sill\u00e4 on olemassa tapoja helpottaa k\u00e4ytt\u00f6ohjeiden kirjoittajan ty\u00f6t\u00e4 ja samalla luoda k\u00e4ytt\u00e4j\u00e4yst\u00e4v\u00e4lliset k\u00e4ytt\u00f6ohjeet lukijoita varten.<\/p>\n

Tehokas tapa vaikuttaa k\u00e4ytt\u00f6ohjeiden k\u00e4ytett\u00e4vyyteen on suunnitteluperiaatteiden k\u00e4ytt\u00f6. Tutkimuksissa on todettu, ett\u00e4 k\u00e4ytt\u00f6ohjeiden k\u00e4ytett\u00e4vyys voidaan saavuttaa suunnitteluperiaatteita hy\u00f6dynt\u00e4m\u00e4ll\u00e4. T\u00e4m\u00e4n perusteella luulisi, ett\u00e4 k\u00e4ytett\u00e4vien k\u00e4ytt\u00f6ohjeiden kirjoittamiseen l\u00f6ytyisi ohjeita kasap\u00e4in. Kuitenkin k\u00e4ytt\u00f6ohjeita nimenomaan k\u00e4ytett\u00e4vyyden n\u00e4k\u00f6kulmasta vakuuttavasti k\u00e4sittelevi\u00e4 ja selkeit\u00e4 suunnitteluperiaatteita antavia l\u00e4hteit\u00e4 on l\u00f6ydett\u00e4viss\u00e4 vain v\u00e4h\u00e4n. Koska olemassa olevat l\u00e4hteet eiv\u00e4t anna luotettavaa ratkaisua k\u00e4ytt\u00e4j\u00e4yst\u00e4v\u00e4llisten k\u00e4ytt\u00f6ohjeiden kirjoittamiseen, p\u00e4\u00e4tin pro gradussani tutkia k\u00e4ytt\u00f6ohjeiden k\u00e4ytett\u00e4vyytt\u00e4 tarkemmin ja koostaa tarvitsemani suunnitteluperiaatteet itse. Perehdyt\u00e4\u00e4n n\u00e4ihin seuraavaksi.<\/p>\n

Suunnitteluperiaatteet<\/h2>\n

Kootut suunnitteluperiaatteet on esitelty alla taulukossa.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n
Suunnitteluperiaate<\/strong><\/td>\nPeriaatteen soveltaminen<\/strong><\/td>\n<\/tr>\n
Teht\u00e4v\u00e4keskeisyys<\/td>\n\n

Rakenna teht\u00e4vien suorittamisesta kokonaisuus, joka n\u00e4kyy my\u00f6s esimerkiksi otsikkotasolla.<\/p>\n

Anna k\u00e4ytt\u00e4j\u00e4lle yksinkertaisia teht\u00e4v\u00e4sarjoja, jotka t\u00e4ht\u00e4\u00e4v\u00e4t konkreettiseen ja k\u00e4ytt\u00e4j\u00e4n tavoitteiden mukaiseen lopputulokseen.<\/p>\n

Kannusta k\u00e4ytt\u00e4j\u00e4\u00e4 toimimaan ja kokeilemaan.<\/p>\n

Muista tasapaino yksityiskohtaisen ja avoimen ohjeistuksen sek\u00e4 toiminnan ja tiedon v\u00e4lill\u00e4.<\/p>\n<\/td>\n<\/tr>\n

Oikea kirjoitustyyli<\/td>\n\n

Kirjoita selke\u00e4sti, asiallisesti ja oikeinkirjoituksen mukaisesti.<\/p>\n

K\u00e4yt\u00e4 imperatiivia ja aktiivilauseita sek\u00e4 puhuttele k\u00e4ytt\u00e4j\u00e4\u00e4 suoraan.<\/p>\n

V\u00e4lt\u00e4 lyhenteit\u00e4.<\/p>\n<\/td>\n<\/tr>\n

Yksinkertaisuus<\/td>\n\n

Kirjoita lyhyesti ja ytimekk\u00e4\u00e4sti, kerro vain oleellinen.<\/p>\n<\/td>\n<\/tr>\n

Tiedon saatavuus<\/td>\n\n

Tee k\u00e4ytt\u00f6ohjeesta helposti selattava.<\/p>\n

Esit\u00e4 tieto havaittavassa muodossa.<\/p>\n

Ohjaa k\u00e4ytt\u00e4j\u00e4 oikeaan paikkaan.<\/p>\n<\/td>\n<\/tr>\n

Virheiden est\u00e4minen ja k\u00e4sittely<\/td>\n\n

Est\u00e4 virheet mahdollisuuksien mukaan ja tarjoa k\u00e4ytt\u00e4j\u00e4lle apua virheenratkaisuun.<\/p>\n

Kerro k\u00e4ytt\u00e4j\u00e4lle virheist\u00e4 hieman enemm\u00e4n: miksi virhe tapahtui ja miten sen voi korjata.<\/p>\n

Korosta virheenkorjauksen yleisperiaatteita erilaisissa tilanteissa.<\/p>\n

Sijoita virheisiin liittyv\u00e4 tieto mahdollisimman l\u00e4helle kuvausta toiminnosta, jossa virhe saattaa tapahtua.<\/p>\n<\/td>\n<\/tr>\n

Yhten\u00e4isyys<\/td>\n\n

Huomioi yhten\u00e4isyys sanavalinnoissa, kirjoitusasussa, rakenteessa ja ulkoasussa.<\/p>\n<\/td>\n<\/tr>\n

Tosiel\u00e4m\u00e4vastaavuus<\/td>\n\n

Esit\u00e4 tieto luonnollisessa j\u00e4rjestyksess\u00e4 ja viittaa tosiel\u00e4m\u00e4n konsepteihin sek\u00e4 teht\u00e4viin.<\/p>\n

Nime\u00e4 k\u00e4ytt\u00f6liittym\u00e4elementit ja j\u00e4rjestelm\u00e4n palaute samoin kuin itse k\u00e4ytt\u00f6liittym\u00e4ss\u00e4.<\/p>\n

Hy\u00f6dynn\u00e4 k\u00e4ytt\u00e4jien kokemusta kirjoista: lis\u00e4\u00e4 sis\u00e4llysluettelo, johdanto, hakemisto ja sanasto.<\/p>\n

K\u00e4yt\u00e4 k\u00e4ytt\u00e4jille tuttua kielt\u00e4, unohda tekninen ammattisanasto.<\/p>\n

Tarkista, ett\u00e4 tiedot on oikein esitetty.<\/p>\n<\/td>\n<\/tr>\n

Joustavuus<\/td>\n\n

Mahdollista lukeminen vapaassa j\u00e4rjestyksess\u00e4.<\/p>\n

Rakenna luvut toisistaan riippumattomiksi.<\/p>\n

Tarjoa oikoreittej\u00e4.<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Suunnitteluperiaatteet valikoituivat listalle sen perusteella, mitk\u00e4 asiat nousivat esille kirjallisuudessa ja ovat perusteltavissa nimenomaan k\u00e4ytett\u00e4vyyden kautta. Suunnitteluperiaatteiden kokoaminen aloitettiin hakemalla ensin laajasti kirjallisuutta, jossa kerrotaan k\u00e4ytt\u00f6ohjeiden k\u00e4ytett\u00e4vyydest\u00e4 ja annetaan k\u00e4ytett\u00e4vyyden parantamiseen t\u00e4ht\u00e4\u00e4vi\u00e4 ohjeita. Kirjallisuuteen tutustumisen j\u00e4lkeen l\u00f6ydetyist\u00e4 l\u00e4hteist\u00e4 eroteltiin jokainen yksitt\u00e4inen suunnitteluohje. Yksitt\u00e4iset suunnitteluohjeet lajiteltiin samansuuntaista tietoa sis\u00e4lt\u00e4viin kokonaisuuksiin ja t\u00e4m\u00e4n j\u00e4lkeen kokonaisuudet nimettiin. Lopputuloksena oli kahdeksan k\u00e4ytt\u00f6ohjeiden k\u00e4ytett\u00e4vyyden suunnitteluperiaatetta.<\/p>\n

Kokoamisen j\u00e4lkeen suunnitteluperiaatteita my\u00f6s arvioitiin vertailemalla niit\u00e4 Nielsenin yleisiin k\u00e4ytett\u00e4vyysperiaatteisiin<\/a> ja tarkastelemalla eri periaatelistojen avulla l\u00f6ydettyjen k\u00e4ytett\u00e4vyysongelmien m\u00e4\u00e4r\u00e4\u00e4 tutkittavaksi valitusta k\u00e4ytt\u00f6ohjeesta. Arvioinnin perusteella voidaan todeta, ett\u00e4 k\u00e4ytt\u00f6ohjeiden k\u00e4ytett\u00e4vyyden suunnitteluperiaatteet soveltuvat paremmin k\u00e4ytt\u00f6ohjeiden p\u00e4ivitt\u00e4miseen, sill\u00e4 Nielsenin k\u00e4ytett\u00e4vyysperiaatteet ovat yleisen tason ohjeita, eiv\u00e4tk\u00e4 n\u00e4in ollen ota huomioon k\u00e4ytt\u00f6ohjeiden ominaispiirteit\u00e4.<\/p>\n

On hyv\u00e4 huomata, ett\u00e4 kootut suunnitteluperiaatteet sopivat parhaiten elektronisessa muodossa oleviin, mutta muuten painettujen ohjeiden kanssa samanlaisiin k\u00e4ytt\u00f6ohjeisiin. Painetuissa tai t\u00e4ysin elektronisissa k\u00e4ytt\u00f6ohjeissa erilaiset asiat saattavat nousta keski\u00f6\u00f6n ja silloin niihin sopivat ehk\u00e4 erilaiset suunnitteluperiaatteet.<\/p>\n

Soveltaminen<\/h2>\n

Kokoamisen ja arvioinnin j\u00e4lkeen koottuja suunnitteluperiaatteita sovellettiin tapaustutkimuksessa Atostekin eRA-palvelun k\u00e4ytt\u00f6ohjeisiin. Saadun palautteen ja tehtyjen havaintojen perusteella k\u00e4ytt\u00f6ohjeiden p\u00e4ivitys paransi eRAn k\u00e4ytt\u00f6ohjeiden k\u00e4ytett\u00e4vyytt\u00e4 huomattavasti, sill\u00e4 niist\u00e4 tuli tarkoituksenmukaisemmat, selke\u00e4mm\u00e4t sek\u00e4 kohtuullisen pituiset.<\/p>\n

Tapaustutkimuksessa suunnitteluperiaatteista tehtiin seuraavat t\u00e4rke\u00e4t havainnot:<\/p>\n

    \n
  • Suunnitteluperiaatteet olivat hy\u00f6dylliset ja k\u00e4ytt\u00f6ohjeiden p\u00e4ivitt\u00e4miseen eritt\u00e4in hyvin soveltuvat. Kootut suunnitteluperiaatteet toimivat todenn\u00e4k\u00f6isesti hyvin my\u00f6s muiden k\u00e4ytt\u00f6ohjeiden p\u00e4ivitt\u00e4misess\u00e4.<\/li>\n
  • Yleisesti ottaen k\u00e4ytt\u00f6ohjeita oli huomattavasti helpompi p\u00e4ivitt\u00e4\u00e4 suunnitteluperiaatteiden perusteella, kuin vain yleiseen k\u00e4ytett\u00e4vyysosaamiseen perustuen, sill\u00e4 kehitetyt periaatteet antoivat konkreettisia esimerkkej\u00e4 ja korjausohjeita. Lis\u00e4ksi periaatteiden avulla oli helpompaa tarttua sellaisiin asioihin, joihin ei ehk\u00e4 muuten olisi tullut kiinnitetty\u00e4 huomiota. Ne my\u00f6s perustelivat sit\u00e4, millaisia muutoksia kannattaa tehd\u00e4.<\/li>\n
  • Teht\u00e4v\u00e4keskeisyys<\/strong> nousi t\u00e4rkeimm\u00e4ksi p\u00e4ivityst\u00e4 ohjaavaksi periaatteeksi. Muita t\u00e4rkeiksi nousseita periaatteita olivat erityisesti yhten\u00e4isyys<\/strong>, joustavuus<\/strong> ja tosiel\u00e4m\u00e4vastaavuus<\/strong>. Vaikka yksinkertaisuus ja tiedon saatavuus olivat sovellettavissa l\u00e4hinn\u00e4 muiden periaatteiden rinnalla, kokonaisuuden kannalta kaikilla periaatteilla oli merkityst\u00e4.<\/li>\n
  • Virheiden est\u00e4minen ja k\u00e4sittely<\/strong> oli periaatteista hankalimmin sovellettavissa. Koska k\u00e4ytt\u00e4j\u00e4 voi tehd\u00e4 virheen k\u00e4yt\u00e4nn\u00f6ss\u00e4 koska tahansa, on vaikea arvioida kohtia, joihin virhetietoa tulisi lis\u00e4t\u00e4. Toisaalta jos itse k\u00e4ytt\u00f6liittym\u00e4 ilmoittaa virhetilanteista, samoja ohjeita on turha toistaa sek\u00e4 k\u00e4ytt\u00f6liittym\u00e4ss\u00e4 ett\u00e4 k\u00e4ytt\u00f6ohjeessa.<\/li>\n
  • Koottujen periaatteiden lis\u00e4ksi k\u00e4ytt\u00f6ohjeiden p\u00e4ivityksen aikana esille nousivat visuaalinen suunnittelu<\/strong> ja tarkkuus<\/strong> eli olennaisten tietojen kertominen mahdollisimman tarkasti. N\u00e4m\u00e4 voitaisiinkin lis\u00e4t\u00e4 uusina periaatteina tai ainakin tarkennuksina olemassa oleviin periaatteisiin.<\/li>\n<\/ul>\n

    Kirjallisuuden ja tapaustutkimuksen perusteella k\u00e4ytt\u00f6ohjeiden kirjoittamisessa ja p\u00e4ivitt\u00e4misess\u00e4 kannattaa soveltaa seuraavia ohjeita:<\/p>\n

      \n
    • K\u00e4ytt\u00f6ohjeiden kirjoittajaksi tai p\u00e4ivitt\u00e4j\u00e4ksi kannattaa valita joku muu kuin j\u00e4rjestelm\u00e4n kehitt\u00e4j\u00e4, jotta k\u00e4ytt\u00f6ohjeita ei kirjoiteta j\u00e4rjestelm\u00e4n kehityksen n\u00e4k\u00f6kulmasta. T\u00e4m\u00e4 auttaa my\u00f6s v\u00e4ltt\u00e4m\u00e4\u00e4n, ettei k\u00e4ytt\u00f6ohjeista tule liian teknist\u00e4.<\/li>\n
    • Kertyv\u00e4n kokemuksen hy\u00f6dynt\u00e4miseksi kirjoittajan\/p\u00e4ivitt\u00e4j\u00e4n kannattaa olla aina sama henkil\u00f6.<\/li>\n
    • Koska k\u00e4ytt\u00e4j\u00e4 on se, jota varten k\u00e4ytt\u00f6ohjeita tehd\u00e4\u00e4n, k\u00e4ytt\u00e4j\u00e4n ja kontekstin huomioiminen mahdollisuuksien mukaan on k\u00e4ytt\u00f6ohjeiden k\u00e4ytett\u00e4vyydest\u00e4 puhuttaessa ehdottoman t\u00e4rke\u00e4\u00e4.<\/li>\n
    • Suunnitteluperiaatteiden k\u00e4ytt\u00f6 kannattaa tehd\u00e4 joustavasti soveltaen j\u00e4yk\u00e4n ohjeiden noudattamisen sijaan. Suunnitteluperiaatteita voi muokata tarpeen mukaan, sill\u00e4 ymp\u00e4rist\u00f6, k\u00e4ytt\u00e4j\u00e4t ja tavoitteet vaihtelevat.<\/li>\n
    • Useiden iteraatiokierrosten k\u00e4ytt\u00f6 helpottaa ty\u00f6t\u00e4. N\u00e4in kaikkia asioita ei tarvitse yritt\u00e4\u00e4 huomioida samanaikaisesti.<\/li>\n<\/ul>\n

      Lopuksi<\/h2>\n

      Miksi kuitenkaan kiireess\u00e4 panostaa ja k\u00e4ytt\u00e4\u00e4 aikaa k\u00e4ytt\u00f6ohjeisiin?<\/strong> Suunnitteluperiaatteisiin tutustuminen ja niiden soveltaminen vie toki hieman aikaa ensimm\u00e4isell\u00e4 kerralla, mutta t\u00e4m\u00e4n j\u00e4lkeen k\u00e4ytt\u00f6ohjeisiin liittyv\u00e4 ty\u00f6 saattaa jopa nopeutua, kun jatkossa ei tarvitse mietti\u00e4 joka kerta uudelleen, miten tiettyj\u00e4 asioita tekisi. Sit\u00e4 paitsi k\u00e4ytt\u00f6ohjeet on teht\u00e4v\u00e4 joka tapauksessa, joten miksi ei kannattaisi panostaa sen verran, ett\u00e4 huonojen k\u00e4ytt\u00f6ohjeiden perinne saataisiin rikottua. Parhaimmillaan t\u00e4m\u00e4 saattaa poikia ihan uudenlaisia positiivisia vaikutuksia, sill\u00e4 k\u00e4ytt\u00f6ohjeet vaikuttavat muun muassa k\u00e4yt\u00f6n turvallisuuteen ja koko j\u00e4rjestelm\u00e4n k\u00e4ytt\u00f6kokemukseen.<\/p>\n

      Pitk\u00e4ll\u00e4 aikav\u00e4lill\u00e4 k\u00e4ytt\u00f6ohjeisiin panostamisesta voi tulla my\u00f6s taloudellisesti kannattavaa, esimerkiksi koska hyv\u00e4 k\u00e4ytt\u00f6kokemus pit\u00e4\u00e4 k\u00e4ytt\u00e4j\u00e4t j\u00e4rjestelm\u00e4n parissa pidemp\u00e4\u00e4n, poikii suositteluja sek\u00e4 saattaa v\u00e4hent\u00e4\u00e4 asiakastuen tarvetta.<\/p>\n

      \n
      \n
      \"\"<\/div>\n
      \n

      Heidi Martikainen<\/strong>
      \nUX Designer<\/em><\/p>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

      Pro gradu -tutkielma \u2022 Kirjoittaja: Heidi Martikainen \u2022 Lue tutkielma K\u00e4ytt\u00f6ohjeiden k\u00e4ytett\u00e4vyydell\u00e4 tarkoitetaan k\u00e4ytt\u00e4j\u00e4n tarvitseman tiedon l\u00f6ytymist\u00e4 helposti lukutottumuksista riippumatta sek\u00e4 sit\u00e4, ett\u00e4 k\u00e4ytt\u00f6ohjeen avulla k\u00e4ytt\u00e4j\u00e4 onnistuu j\u00e4rjestelm\u00e4n k\u00e4ytt\u00f6liittym\u00e4n k\u00e4yt\u00f6ss\u00e4 ja oppii k\u00e4ytt\u00f6liittym\u00e4n k\u00e4ytt\u00f6\u00e4 pidemm\u00e4ll\u00e4 aikav\u00e4lill\u00e4 paremmin kuin h\u00e4n ilman k\u00e4ytt\u00f6ohjetta oppisi.<\/p>\n","protected":false},"author":4,"featured_media":6800,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false},"categories":[104,3],"tags":[141,140,143,136,144,142],"_links":{"self":[{"href":"https:\/\/atostek.com\/wp-json\/wp\/v2\/posts\/6784"}],"collection":[{"href":"https:\/\/atostek.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/atostek.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/atostek.com\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/atostek.com\/wp-json\/wp\/v2\/comments?post=6784"}],"version-history":[{"count":0,"href":"https:\/\/atostek.com\/wp-json\/wp\/v2\/posts\/6784\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/atostek.com\/wp-json\/wp\/v2\/media\/6800"}],"wp:attachment":[{"href":"https:\/\/atostek.com\/wp-json\/wp\/v2\/media?parent=6784"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/atostek.com\/wp-json\/wp\/v2\/categories?post=6784"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/atostek.com\/wp-json\/wp\/v2\/tags?post=6784"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}