Cum să creați instrucțiuni pas cu pas utilizând elemente vizuale

Există câteva tutoriale care necesită mai mult decât text pentru a fi înțelese de către cititori. Prin crearea de instrucțiuni pas cu pas folosind elemente vizuale, puteți introduce cititorii în detalii care altfel nu ar fi fost comunicate. Aceste imagini ar putea fi imagini statice sau capturi de ecran, GIF-uri animate, diagrame de comparație sau videoclipuri. Pe lângă faptul că îi ajută pe cititori să vă înțeleagă conținutul, elementele vizuale distrug și monotonia unei cantități mari de text.

În ultimul an, am lucrat ca scriitor tehnic pentru Joyent, scriind instrucțiuni și creând videoclipuri destinate utilizatorilor de toate nivelurile de calificare. Acest lucru necesită precizie — oamenii se bazează pe mine pentru a crea instrucțiuni pas cu pas și ghiduri pentru o sarcină tehnică. Dacă ratez un pas sau presupun că cititorii cunosc deja o informație, s-ar putea să plece frustrați și să nu mai revină niciodată la conținutul nostru. Pe de altă parte, dacă sunt prea detaliat, conținutul ar putea să pară excesiv și divagator, precum și să necesite actualizări mai frecvente. Nici o presiune.

Găsirea locurilor în care o imagine poate înlocui unele dintre acele detalii prea precise mă economisește timp și energie. În plus, cititorii pleacă știind ce se așteaptă să vadă, ceea ce, sperăm, le face viața mai ușoară. Ori de câte ori este posibil, urmați câteva sfaturi cheie de scriere: arată, nu spune (atât de esențial că are propria pagină Wikipedia).

Nu trebuie să fii un scriitor tehnic pentru a beneficia de un limbaj precis al procesului. Continuați să citiți pentru strategii de pregătire a instrucțiunilor și de a adăuga elemente vizuale oricărui document.

Înainte de a începe să vizualizați, luați în considerare publicul dvs

Înainte de a produce orice conținut, ar trebui să știți pentru cine îl produceți și care sunt așteptările acestora. Deși este imposibil să anticipați nevoile individuale ale fiecărui cititor, regulile pe care le stabiliți influențează tonul conținutului dvs. și vă pot ajuta să luați decizii mai târziu, atunci când vă creați schița procesului.

Luați în considerare următoarele:

• Cititorii mei sunt deja experți? Au făcut acest proces înainte, dacă nu chiar atunci în circumstanțe similare?
• Cititorii mei sunt interni sau externi? Dacă cititorii mei se află în cadrul aceleiași companii, ce limbă împărtășim care ne va ajuta să explicăm mai bine procesul?
• Cu ce ​​dispoziție vor fi mulțumiți de mine? Creez acest conținut pentru cineva care se grăbește să facă ceva sau este pentru un cursant mai ocazional care doar speră să-și continue educația pe un subiect?
• Ce este cel mai important pentru cititorii mei? Ce este cel mai puțin important?
• Cum preferă cititorii mei să învețe? Știu dacă o postare pe blog are mai mult succes decât un videoclip? Există date analitice care să susțină aceste afirmații?
• Sunt cititorii mei vorbitori nativi de engleză? Dacă folosesc un limbaj, le va împiedica capacitatea de a învăța cum să finalizeze procesul?

Indiferent ce creați, îl creați întotdeauna cu un cititor la celălalt capăt. Cu cât vă cunoașteți mai bine cititorul și produceți conținut având în vedere el, cu atât este mai probabil ca acesta să revină pentru mai mult conținut.

Schițați procesul doar cu atâtea detalii cât este necesar

O modalitate de a pregăti un proces sau un tutorial pentru orice mediu este să începeți cu un tabel cu două coloane. Prima coloană va conține fiecare pas individual pe care cititorul trebuie să-l facă pentru a finaliza o sarcină. Acești pași pot fi la fel de mici și precisi precum „trimiteți cererea” sau la fel de mari și nespecifici precum „completați restul formularului”.

A doua coloană va fi coloana procesului vizual. La început, este posibil să nu includă deloc imagini reale, ci o descriere a ceea ce vor fi imaginile. Dacă creați un document scris, nu este necesar să aveți un element vizual potrivit pentru fiecare pas din coloana unu. Dacă veți crea un screencast, fiecare casetă ar trebui să aibă o notă despre tipul de vizual care trebuie inclus. Ar trebui să existe puțin sau deloc timp de ecran gol într-un videoclip.

Un exemplu al acestui tabel este mai jos, sub „Exemplu de schiță”, dar mai întâi trebuie să aflați mai multe despre tipurile de ajutoare vizuale.

Tipuri de imagini și când să le folosești

Fiecare proces poate beneficia de diferite tipuri de imagini. Mediul se va schimba în funcție de scopul său.

• Imagini statice – acesta este mediul perfect atunci când încercați să vizualizați un produs fizic, fie el o persoană sau un obiect specific, cum ar fi un tip de tigaie. Acestea pot fi fotografii de stoc sau fotografii pe care le-ați făcut.
• Captură de ecran – o imagine statică a ecranului dvs. este excelentă atunci când vorbiți despre produse care sunt văzute pe computer, cum ar fi un site web sau un alt program. Sunt foarte ușor de luat și de editat, în special datorită Snagit.
• GIF – imaginile animate sunt perfecte pentru a explica procese scurte (sub 8 secunde) care ar putea să nu fie la fel de ușor de articulat.
• Diagramă – diagrame cu bare, diagrame circulare, diagrame cu linii, atât de multe tipuri de diagrame! O diagramă este cea mai bună alegere atunci când vorbim despre și comparăm un set de numere.
• Video – imaginea supremă, un videoclip este grozav pentru a explica un proces. Cum să faci un videoclip tehnic grozav este o formă de artă care poate fi ajutată cu siguranță de acest proces, dar necesită mult mai multă planificare. (Din norocul tău, am învățat multe de la TechSmith și au multe de spus despre acest subiect).

Simțiți-vă liber să utilizați o combinație de medii cu scrisul dvs. Fiecare va răspunde nevoilor diferite pentru pași diferiți.

Exemplu de schiță

Rețetele sunt unul dintre cele mai bune exemple de proces care necesită adesea precizie în care imaginile pot face o diferență uriașă. Să presupunem că vreau să subliniez instrucțiunile pentru a face un tort:

masa {

border-colaps: colaps;

}

masa, td, th {

chenar: 1px solid #404040;

umplutură: 4px;

}

Dacă fiecare pas ar avea o imagine, asta ar fi puțin... gratuit.

Alege-ți imaginile

Imaginile pe care le-am selectat sunt utile în articularea mini-proceselor într-un proces mai mare. În special, imaginea din pasul 7 a amestecului amestecat până acum este o dovadă vizuală crucială. După ce am copt o serie de prăjituri cu această instrucțiune, diferența dintre exact și prea amestecat... Mi-aș dori să am mereu o imagine. Ar putea exista un manual de instrucțiuni scris doar cu privire la complexitatea duratei de amestecare - fiecare altă pagină ar trebui să fie o imagine.

După ce ai subliniat ce imagini vizuale aveți nevoie, trebuie să colectați bunurile. Pentru acest exemplu, cel mai bine ar fi să fotografiați procesul de coacere a unui tort. Pentru alte procese, este posibil să nu fie nevoie să faceți fotografii personalizate. Există o varietate de site-uri web de fotografie de stoc gratuite și premium care au videoclipuri, GIF-uri și fotografii care pot fi folosite la discreția dvs.

Testarea cu publicul țintă

Niciun articol nu este complet până când nu a fost citit de cineva din publicul țintă și a primit un sigiliu de aprobare. Contribuția lor va demonstra unde ați ratat un pas în procesul dvs. sau unde sunt necesare mai multe elemente vizuale.

Cea mai ușoară modalitate de a face acest lucru (fără resursele mari ale unei echipe de utilizare) este să ceri câțiva oameni din grupul tău cheie să citească conținutul și să încerce să urmeze procesul exact așa cum este scris. Jakob Nielsen este adesea citat spunând că cinci este cel mai bun număr de oameni pentru a prinde cele mai multe probleme.

Testare nemoderată

Testarea nemoderată este perfectă pentru proiecte mai mici cu resurse limitate - sau doar atunci când aveți nevoie de rezultate rapid. Există o serie de instrumente pe care le puteți folosi pentru rezultate mai precise, dar dacă sunteți în căutarea doar pentru feedback cu privire la un proces mai mic, este posibil să puteți scăpa trimițând documentul testerilor dvs. cu un set de întrebări pe care le doriți. răspuns.

Cereți-i pe testeri să ia notițe ori de câte ori au întrebări, să vadă ceva care poate lipsi, să întâmpine obstacole în acest proces sau și-ar dori să aibă instrucțiuni mai detaliate. Sperăm că vor putea termina sarcina înainte de a vă oferi feedback.

Testare moderată

Cel mai mare beneficiu al testării moderate este că vă puteți urmări de fapt testerul care efectuează procesul și să vedeți unde sunt confuzi, în loc să vă bazați pe el pentru a observa acea confuzie pentru dvs. Este și mai bine dacă înregistrați sesiunea pentru a nu fi nevoit să vă bazați exclusiv pe notele pe care le luați în timpul acestei sesiuni.

Pune întrebări pe parcurs. De exemplu:

• Ai înțeles ce sarcină ți se cere să îndeplinești? A avut sens această sarcină?
• Ce ar fi făcut acest proces mai ușor de finalizat?
• Dacă a existat un vizual cu un pas, vizualul te-a ajutat să înțelegi ce să faci?
• Ați vrea să fi fost mai multe imagini?

Încheierea

Acum știți de ce ar trebui să adăugați elemente vizuale la instrucțiunile pas cu pas și să aveți un arsenal de instrumente care să vă ajute să creați cu succes instrucțiuni pas cu pas cu ajutorul ajutoarelor vizuale. Practica face perfect. Prima încercare de a adăuga imagini la un proces poate să nu fie perfectă, dar cu unele teste de utilizator pentru a vă ghida procesul de editare, veți fi pe cale de a ajuta utilizatorii să înțeleagă cum să finalizeze o sarcină.

Aveți altă metodă de a afla când să adăugați ajutoare vizuale la instrucțiuni? Împărtășește-ți sfaturile în comentariile de mai jos!

Nota editorului: această postare a fost publicată inițial în noiembrie 2017 și a fost actualizată pentru acuratețe și exhaustivitate.