Overzicht van Instructies ("How-to's")

Wat?

Instructies leiden jou, de lezer, door de stappen die nodig zijn om een praktisch probleem op te lossen. Ze zijn doelgericht.

Zeg wat?

Je moet in staat zijn om dingen te bereiken. Als ze "goed zijn gemaakt", zijn dit de meest gelezen onderdelen van je documentatie.

Wat ze doen

Ze begeleiden. Ze demonstreren.

Beantwoorden de vraag

"Hoe doe ik...?"

Gericht op

Doelen. Taken. Ze dienen de behoefte van de gebruiker om te werken. Ze zetten de vaardigheid aan het werk en helpen de gebruiker een taak te volbrengen.

Doel

om te tonen hoe een specifiek probleem/vraag op te lossen
om de reeds competente gebruiker te helpen een bepaalde taak correct uit te voeren

Vorm

Een reeks stappen.

Analogie

Niet iemand leren koken, maar een recept in een kookboek volgen.

Mijn verantwoordelijkheid

Blijf bij het praktische doel.

Aanpak

Ik zal geen concepten/zaken uitleggen, maar verwijs naar een referentiegids voor een volledige lijst van opties
Ik zal een startpunt bieden dat je weet te bereiken; hoogstwaarschijnlijk ben je ook al midden in iets bezig
het pad kan niet beheerd worden: het is de echte wereld!
Ik ga uit van vertrouwdheid
instructies zijn van toepassing op de echte wereld: je zult moeten omgaan met wat ik je voorschotel
je moet je voorbereiden op het onverwachte
je zult moeten vertrouwen op impliciete kennis
en een specifieke taak voltooien
instructies zijn betrouwbaar, maar niet met de ijzersterke herhaalbaarheid van een tutorial; ze kunnen geen veiligheid beloven
Ik zal conditionele imperatieven gebruiken
en algemene benaderingen