Jargon herkennen en uitleggen voor je doelgroep.
Een term kan voor experts passend zijn en voor beginners verwarrend. Bepaal eerst de doelgroep en leg onbekende termen bij de eerste bruikbare vermelding uit.
Stem de werkwijze af op je taak.
Schat de kennis van de lezer in en markeer termen die begrip hinderen. Behoud waar nodig precieze vaktaal en voeg bij de eerste bruikbare vermelding een eenvoudige uitleg toe, in plaats van elke term te vervangen.
- Wat je aanlevert
- Specialistische tekst en lezersprofiel.
- Wat je krijgt
- Gemarkeerd onverklaard jargon met definities.
Bekijk de invoer en het resultaat.
Illustratieve invoer en uitvoer · een leervoorbeeld, geen live uitvoering van WebAct
Voorbeeld invoerveld
Explain to a new customer: Configure the webhook and inspect the payload.
Uitgewerkt voorbeeld
Set up the webhook, an automatic message sent between services, then check the payload: the data included in that message.
Laad deze invoer in de prompt en kopieer deze naar WebAct om de taak te proberen. Je resultaat kan afwijken van het voorbeeld.
Keuzes en probleemoplossing.
Moeten vaktermen verdwijnen uit documentatie voor experts?
Nee. Leg alleen uit wat de beoogde lezer nodig heeft. Gangbare vaktermen kunnen expertendocumentatie korter en preciezer maken.
Wat als de eenvoudige vervanging niet klopt?
Behoud de oorspronkelijke term en voeg een korte definitie of een voorbeeld toe. Een bekend maar onnauwkeurig synoniem kan juist meer verwarring scheppen.
Probeer het met je eigen bron.
Vervang het voorbeeld door je eigen materiaal in de taakprompt. Behoud de eisen die je nodig hebt en kopieer de taak naar WebAct.
De taak aanpassen en kopiëren ↑