Digitoodete kasutajajuhendite koostamine

Üks juhend (taskugiid), näiteks ehituse infosüsteemide taskugiid, on oma taskugiidi veebilehel.

Veebileht peab arvestama oma ülesehituses vastavate digitoodetega kaetud teenuste kasutajate kasutajaprofiiliga ja sellega, mil viisil kasutajad oma tegevusi tavaliselt läbi viivad.

Juhendi sisu on jagatud menüü kaudu ligi pääsetavatesse plokkidesse.

Juhendi koostamisel kujuta ette, et pildid on juhendi vahelt ära kadunud. Juhend peab olema arusaadav ka siis, kui mitte ühtegi pilti teksti vahel ei ole. Seega peab kogu info, mis on pildil, olema kindlasti ka tekstina juhendis välja kirjutatud. Seal hulgas tähelepanu pööramine nupule (kirjuta välja nupu nimetus), tegevuste järjekord (nummerda sammud) vms. See tekst ei tohi olla osa pildist - peab olema kindlasti trükitud, mitte raster.

Kui teksti osutab millelegi pildil, on hea, kui pildil on see kindel koht markeeritud. Seda võib teha noolega või ovaaliga. Markeering peab olema selgelt ja kontrastselt värvitooni ja disaini poolest eristatav kasutajaliidese enda disainist.

Üldjuhul peab kogu juhendi tekst olema näha juhendi lehel kohe ilma selleta, et millelegi ekstra klikkima peaks. Küll aga võib eraldi avanevasse plokki (nn akordion) panna lisainfo, mis ei ole esmatähtis. Selleks võivad olla illustreerivad näidised või laiendava infoga täiendused juhendile.

Pikema juhendi korral tuleb juhendilehe algusesse lisada sisukorra komponent, kus soovitav on välja lülitada alumise taseme pealkirjade viited.

Tavapäraselt tabeli kujul esitatud info tuleb juhendisse vormistada ümber loendina. Seda kahel põhjusel

• juhendi alustehnoloogia ei võimalda kasutajasõbralikult tabelit esitada,

• pildina tabeli lisamine ei võimalda sellest infot masinloetaval kujul kätte saada.

Lubatud on tabeli pildina lisamine vaid juhul, kui tabelis olev info ei ole oluline juhendi sisu esmaseks mõistmiseks, vaid on juhendi materjali täiendava näitena kasutatud.

Juhendist ammutab sisu ka AI, näiteks kasutajatoe juturobot. Juturoboti õppematerjaliks on kõige parem tekst: laused ja loetelud. Pildimaterjalist ja tabelitest on robotil hulga keerulisem sisu ammutada. Sama kehtib kae kraanilugeja kohta.

Kuna juhendeid on vaja tihti täiendada seosest kasutajakeskkonnas toimuvate arenduste ja muudatustega või lihtsalt seetõttu, et juhendis on teksti tarvis täpsustada, peab juhend ise olema lihtsalt hallatav. Selleks on hea, kui lehe sisu on tükeldatud plokkidesse nii, et nende järjekorda on lihtne liigutada, pilte võimalik kiiresti välja vahetada, teksti mugav muuta.

See tähendab, et tekstid ja pildid ei tohi olla ükteise järel ühes sisuplokis, vaid eraldi sisuplokkides. Nii on võimalik mitme pildi vahel ühte välja vaetada ilma, et haldamisest segadus tekib. Eraldi sisuplokki ei saa jagada sisu, mida on soov kokkupakitavasse akordionisse panna.