Tölvumál - 01.05.1986, Blaðsíða 13

Tölvumál - 01.05.1986, Blaðsíða 13
- að byrja á byrjuninnil - snyrtileg uppsetning, sem gefur bðkinni greinilega heildarmynd - stuttar og hnitmiðaðar setningar - stuttar málsgreinar - að forðast tæknimál og skammstafanir - að endurtekningar eiga rétt á sér í handbðkum - að gefa dæmi með skýringartexta um raunhæfa vinnslu Sá, sem skrifar handbðk, þarf að sjálfsögðu að þekkja hvernig forritið vinnur. ffiskilegast er að hann fylgist með þegar forritið er hannað, þannig að handbðk og forrit séu tilbúin samtímis. Hann þarf því að vinna hratt, en skipulega, og fS gagnrýni á handritið á öllum vinnslustigum þess. 1 einum af fyrstu köflum handbókar má gjarnan vera lausleg kynning á helstu atriðum i stýrikerfi tölv- unnar, svo sem skráarnöfn, hvernig tekin eru afrit og nokkur fleiri undirstöðuatriði. Þar á eftir er nauðsynlegt að skapa, notandanum öryggistilfinningu með því að kynna honum á einfaldan hátt hvernig komast má inn og ut ör forritinu. Slðan er skrifað um hvern þátt vinnslunnar fyrir sig 1 sérstökum köflum. Þeir mega gjarnan hafa undirkafla til aðgreiningar á aðalatriðum. Þar er farið nákvæm- lega yfir hvert einstakt atriði í vinnslunni og sýnd dæmi. Nauðsynlegt er að hafa kafla með samandregnu efni, sem notandi getur flett upp í þegar hann er orðinn nokkuð öruggur í notkun forritsins. Hann er ágætt að hafa aftast eða aftarlega í bðkinni til þess að hann eða þeir rugli ekki byrjendur. Handbðkin er þá ekki lengur lesin í smáatriðum, heldur notuð sem upp- flettibðk. Atriðisorðaskrár (Index) eru mjög nytsamlegar. 1 þeim þurfa að koma fram blaðsíðutöl fyrir flest þau atriði, sem minnst er á I handbókinni, þar með talin dæmi. Ef þessi atriði eru höfð í huga gæti handbðkin - 13 -

x

Tölvumál

Beinir tenglar

Ef þú vilt tengja á þennan titil, vinsamlegast notaðu þessa tengla:

Tengja á þennan titil: Tölvumál
https://timarit.is/publication/239

Tengja á þetta tölublað:

Tengja á þessa síðu:

Tengja á þessa grein:

Vinsamlegast ekki tengja beint á myndir eða PDF skjöl á Tímarit.is þar sem slíkar slóðir geta breyst án fyrirvara. Notið slóðirnar hér fyrir ofan til að tengja á vefinn.