Muistilistojen laatimisohjeet
Muistilistojen ja koostemuistilistojen avulla käyttäjä pääsee tiettyyn tavoitteeseen tekemällä loppuun sarjan vaiheita. Näissä ohjeissa käsitellään muistilistojen käyttötilanteita ja parhaita tapoja laatia muistilista.
Milloin kannattaa luoda muistilistoja?
Muistilistat sopivat hyvin vaiheittain eteneviin tehtäviin, joissa on selkeä päämäärä, kuten yksinkertaisen sovelluksen koonti. Päämäärä tulee määrittää selkeästi, jotta käyttäjä huomaa onnistuneensa, kun kaikki muistilistan vaiheet on tehty loppuun. Opetusohjelmat ovat usein sopivia kohteita muistilistoille, sillä opetusohjelman päämääränä on oppia tietyn tehtävän suoritus. Muistilistat sisältävät yleensä enintään 10 vaihetta, jotka voi tehdä loppuun vähintään puolessa tunnissa.
Laajempien tehtävien yhteydessä kannattaa käyttää koostemuistilistoja.
Milloin kannattaa luoda koostemuistilistoja?
Koostemuistilistoja käytetään ohjaamaan käyttäjää tehtävissä, jotka ovat liian laajoja yksittäisen muistilistan kuvattaviksi tai joissa on useita päämääriä. Koostemuistilistaa voi käyttää kuvaamaan tehtäväsarjaa, jossa kukin tehtävä perustuu sitä edeltäneeseen tehtävään.
Milloin muistilistoja ei kannata käyttää?
Muistilistat toimivat parhaiten tilanteessa, jossa tehtävän voi viedä loppuun tekemällä sarjan yksinkertaisia vaiheita. Muistilistat eivät korvaa ohjejärjestelmää, jonka avulla voi luoda graafisesti monimutkaisia ja hakutoimintojen sekä hyperlinkkien avulla toteutetun tietojen hajasaannin sisältäviä HTML-sivuja. Muistilistoja ei ole tarkoitettu käytettäviksi sellaisten tehtävien yhteydessä, joissa käyttäjän on kirjoitettava suuria määriä tekstiä.
Ohjeita muistilistan luontiin
- Valitse lyhyt ja ytimekäs otsikko.
- Tuo saataville tausta- tai yksityiskohtaisia tietoja aiheesta käyttämällä muistilistatehtävien yhteydessä linkkejä ohjejärjestelmään aina, kun se on mahdollista.
- Harkitse muistilistan laatimista uudelleen koostemuistilistaksi, jos siinä on enemmän kuin 10 vaihetta.
- Suorita yksinkertaiset mutta työläät tehtävät, kuten perspektiivien tai resurssien avaus ja ohjattujen toimintojen ajo, valikon vaihtoehtojen avulla aina, kun se on mahdollista. Muista myös kuvata, kuinka saman tehtävän voi suorittaa ilman valikon vaihtoehtoa.
- Varmista, että valikon vaihtoehdot voidaan ohittaa, jos käyttäjä haluaa tehdä vaiheet manuaalisesti
- Määritä merkintä dialog="true" vaiheille, joissa avataan valintaikkunoita. Tämä aiheuttaa muistilistan avautumisen "lokeroon", joka sijaitsee useimpien valintaikkunoiden oikealla puolella.
- Järjestä vaiheet niin, että käyttäjä kokee edistyvänsä niitä tehdessään. Esimerkiksi muistilista, jossa tehdään useita muutoksia java-lähteeseen ja jossa tämän jälkeen aloitetaan sovellus, voitaisiin laatia uudelleen niin, että sovellus aloitetaan jokaisen lähteeseen tehdyn muutoksen jälkeen.
- Varmista, että käyttäjä ymmärtää, minkä takia kukin vaihe tehdään.
- Kaikkia vaiheiden tekotapoja ei kannata kuvata, vaan valitse yksinkertaisin tekotapa, joka on myös helpointa kuvata.
- Paranna luettavuutta käyttämällä break-tunnisteita (<br/>).
- Alikohtien avulla vaiheet voi jakaa pienempiin vaiheisiin.
- Kaikissa muistilistoissa alikohtia ei tarvita.
- Aloita alikohdan nimiöteksti käyttämällä toimintosanaa, kuten sanoja "Input", "Expand" ja "Select".
- Yksilöi alikohtien nimiöissä liittymäteksti selkeästi käyttämällä lainausmerkkejä, jotta käyttäjät erottaisivat ohjetekstin liittymätekstistä, joka heidän tulee hakea ja jonka kanssa heidän tulee olla vuorovaikutuksessa.
- Kunkin alikohdan tulee vastata yhdestä yksittäisestä tehtävästä, kuten yhden arvon syötöstä.
- Lisää aina <onCompletion>-elementti muistilistan viimeiseen vaiheeseen.
- Testaa muistilistaa erikokoisilla muistilistanäkymillä.
- Testaa muistilistaa virhelokinäkymän ollessa auki, jotta näet, kirjautuuko lokiin varoituksia.
Ohjeita koostemuistilistan luontiin
- Koostemuistilistan tulee sisältää tehtäviä, jotka liittyvät toisiinsa yhteisen teeman kautta.
- Kullakin koostemuistilistan tehtävällä tulee olla selkeästi määritetty päämäärä.
- Ilmoita käyttäjälle onnistumisista käyttämällä <onCompletion>-elementtejä.
- Tehtävien nimien tulee olla lyhyitä ja ytimekkäitä.
- Monimutkaiset tehtävät voidaan suorittaa käyttämällä tehtäviä, jotka perustuvat niitä edeltäneisiin tehtäviin.
- Käytä merkintää skip="true", jos tehtävä on valinnainen.
- Jotta muistilistat olisivat yhtenäisiä, varmista, että yksinkertaisen muistilistan esittely ja nimi vastaavat koostemuistilistassa määritettyä esittelyä ja nimeä.
- Yksilöi tehtävien kuvauksissa liittymäteksti selkeästi käyttämällä lihavointia muotoilussa.
- Sequence-lajia tulee käyttää vain silloin, kun tehtävien aloitusjärjestys on tärkeää pitää tietynlaisena.
Aiheeseen liittyviä linkkejä
Muistilistojen käyttö
Koostemuistilistojen käyttö
Tavalliset muistilistat
Koostemuistilistat