Klik hier om te helpen David McMurrey betalen voor webhosting:
Doneer elk klein bedrag dat je kunt!
Online technisch schrijven blijft gratis.
Een andere nuttige informatiestructuur die vaak wordt gebruikt in technische documentatie is vergelijking.
Wat is vergelijking?
In technische schrijvers zijn vergelijkingen erg belangrijk. Korte vergelijkingen met vergelijkbare of vertrouwde dingen kunnen lezers helpen een onderwerp beter te begrijpen; vergelijkingen kunnen ook helpen bij het beslissingsproces om een optie uit een groep te kiezen. Een uitgebreide vergelijking, die de focus in dit hoofdstuk is, is een of meer paragrafen waarvan het belangrijkste doel en de structuur het vergelijken is. Een type vergelijking de analogie, wat een speciale vorm is van uitgebreide vergelijking van een onbekend ding met een bekend ding.
Uitgebreide vergelijkingen kunnen zijn informatief of evaluatief. Een informatieve vergelijking probeert het onderwerp te vergelijken met iets vergelijkbaars of bekends om mensen te helpen het onderwerp te begrijpen of, in sommige gevallen, om mensen beide beter te laten begrijpen. Een evaluatief vergelijking probeert één of meer van de opties aan te bevelen door ze te vergelijken. Dit is de focus van de soorten rapporten die in het gedeelte over aanbevelingsrapporten, haalbaarheidsrapporten, evaluatierapporten.
Opmerking: Zorg ervoor dat je de voorbeelden van vergelijking.
NotebookLM-gegenereerde infographic van dit hoofdstuk
Hoe vergelijkingspunten te identificeren?
Wanneer je een uitgebreide vergelijking schrijft, moet je beginnen met het identificeren van de specifieke manieren waarop je de dingen gaat vergelijken waar je over wilt schrijven. Deze vergelijkingspunten zijn als categorieën van vergelijkende details. Bijvoorbeeld, in een evaluatieve vergelijking van smartphones, zou je waarschijnlijk de beste vier of vijf toestellen willen vergelijken op basis van het volgende:
- kosten
- gebruiksvriendelijkheid
- betrouwbaarheid
- speciale kenmerken, enzovoort
Als je niet begint met het identificeren van de vergelijkingspunten, kan je vergelijking ongelijk worden—bijvoorbeeld, je zou kunnen zeggen dat model 1 gemakkelijk te gebruiken is, maar verder niets zeggen over het gebruiksgemak van modellen 2, 3 of 4.
Hoe vergelijkingen te organiseren?
Een van de belangrijkste concepten om te leren bij het schrijven van vergelijkingen heeft te maken met het organiseren van de inhoud. Er zijn twee basismanieren om een vergelijking te organiseren:
- geheel-tot-geheel benadering
- stapsgewijze benadering
Om een gevoel te krijgen voor hoe deze twee benaderingen werken, kijk naar de volgende illustratie van deze twee benaderingen. In de geheel-op-geheel benadering worden details over elk van de vergeleken opties samengevoegd. Dit is onze natuurlijke neiging—maar het doet een slordige, ongelijkmatige poging om de vergelijkingen te formuleren. De betere manier is om de punt-voor-punt benadering te gebruiken. In het schema in de illustratie zou je één alinea hebben die de kosten van de modellen A, B en C vergelijkt; dan een andere alinea die de garanties van de drie modellen vergelijkt; enzovoort.
Gebruik de punt-voor-punt benadering, tenzij iets over je onderwerp, doel of publiek anders dicteert. Bij de geheel-voor-geheel benadering is de vergelijking vaak ongelijk—je zou kunnen vergeten om iets te vertellen over de garanties voor Model B; je zou kunnen verzuimen om de werkelijke resultaten van de vergelijking—te vermelden dat Model C beter is wat betreft speciale functies. Bij de geheel-voor-geheel benadering laten schrijvers vaak de werkelijke vergelijkingen aan de lezer over, in de veronderstelling dat het slechts geven van de ruwe gegevens voldoende is.
In de punt-voor-punt benadering zou elk van de vergelijkende secties moeten eindigen met een conclusie die aangeeft welke optie de beste keuze is in die specifieke categorie van vergelijking. Natuurlijk zal het niet altijd gemakkelijk zijn om een duidelijke winnaar aan te wijzen—je zult de conclusies op verschillende manieren moeten nuanceren, waarbij je meerdere conclusies voor verschillende voorwaarden biedt.
Schematische weergave van de geheel-tot-geheel en de deel-tot-deel benaderingen voor het organiseren van een vergelijking. Tenzij je een zeer ongewoon onderwerp hebt, gebruik dan de punt-voor-punt aanpak.
Korte alinea-vergelijking
Hoe vergelijkingen te schrijven?
Net als bij causale discussies zijn vergelijkingen niet onderscheidend vanwege een bepaalde soort inhoud. In plaats daarvan zijn het de speciale overgangswoorden die vergelijkende teksten laten werken: bijvoorbeeld, "vergelijkbaar, " "niet zoals, " "meer dan, " "minder dan, " en andere dergelijke woorden die de aandacht van de lezers vestigen op vergelijkingen en de resultaten van die vergelijkingen benadrukken. Let op hoeveel er worden gebruikt in de illustraties in dit hoofdstuk.
Wanneer je vergelijkingen schrijft, let dan goed op het gebruik van deze overgangswoorden. Benadruk de gelijkenissen en verschillen—dwing de lezers niet om ze zelf uit te zoeken.
Schematisch overzicht van vergelijkingen. Vergeet niet dat dit slechts een typisch of algemeen model is voor de inhoud en organisatie—veel andere zijn mogelijk.
Hoe vergelijkingen te formatteren?
Vergelijkingen vereisen geen speciaal formaat; gebruik gewoon koppen, lijsten, mededelingen en afbeeldingen zoals je zou doen in elk ander technisch document. Voor details, zie:
Gerelateerde Informatie
Leesquiz. Gebruik deze quiz om je begrip van dit hoofdstuk te testen.
Beschikbare training. Oefen met schrijven met McMurrey als uw instructeur.
Ik waardeer je gedachten, reacties en kritiek over dit hoofdstuk: antwoord—David McMurrey
