RSS

Vad är howtos, guider, manualer?

16 Jan

Det här med att förklara hur man gör saker på en dator är inte lätt. Hur man gör beror på vad man vill beskriva, varför och för vem. Ur det uppstår några olika genrer som har olika namn. Ibland har jag undrat vad dessa ord står för. Jag är ju trots allt pedagog till yrket.

Doctor Mo har, på förekommen anledning skulle man kunna säga, försökt ge sin förklaring på några vanliga begrepp. Jag har här försökt översätta dem så gott jag kan.

  • How to – en beskrivning av ett visst arbetsflöde med en lista på kommandon med en kort beskrivning av vad de gör.
  • Guide – en genomgång av ett visst arbetsflöde med utförliga förklaringar och tangenter att använda.
  • Teknisk dokumentation – ett dokument som beskriver den inre uppbyggnaden och mekaniken.
  • Användardokumentation – en förklaring för användaren av varje möjlig funktion som finns och hur man använder dem.
  • Manual – en blandning av en guide och en dokumentation.
  • Definition – en kort beskrivning av hur något används och hur det fungerar, men utan exempel.

Det här är inte uttömande på något sätt och inte heller så enkelt som det kan verka. Inte ens Doctor MO:s definitioner känns speciellt klara och tydliga. Man skulle behöva fundera lite närmare på det här.

Hans definitioner har inget med var man skriver eller vilken teknik man använder för att skriva. Det handlar mer om vad som ska beskrivas och för vem. De olika typerna har olika stil för att berätta. Och det är den sidan av saken som intresserar mig som pedagog.

Dessutom har begreppet manual en alldeles speciell betydelse i Linuxvärlden. Det är den beskrivning av ett program som om man skriver ‘man’ och sedan namnet på programmet i en terminal. Det här brukar ge en beskrivning av vad programmet gör och hur man använder det.

Men här får begreppet manual en lite annorlunda innebörd i och med att Doctor MO är inblandad i The Ubuntu Manual. A beginners guide., som då är både manual och guide. Och vad gör en manual till en blandning av två genrer? Språklig förveckling?

Är du förvirrad? Det här känns inte alls glasklart, eller hur?

Vill du få lite olika infallsvinklar på det här, kan du titta på följande sidor på Wikipedia.

 
2 kommentarer

Publicerat av på 16 januari 2010 i Dator

 

Etiketter: , , , , , ,

2 svar till “Vad är howtos, guider, manualer?

    • Maths

      12 juni 2013 at 21:00

      Tack! Det är den andra länken som jag tänkte mig. Jag har nu ändrat.🙂

       

Kommentera

Fyll i dina uppgifter nedan eller klicka på en ikon för att logga in:

WordPress.com Logo

Du kommenterar med ditt WordPress.com-konto. Logga ut / Ändra )

Twitter-bild

Du kommenterar med ditt Twitter-konto. Logga ut / Ändra )

Facebook-foto

Du kommenterar med ditt Facebook-konto. Logga ut / Ändra )

Google+ photo

Du kommenterar med ditt Google+-konto. Logga ut / Ändra )

Ansluter till %s

 
%d bloggare gillar detta: