All categories/Writing and copy
Editing and proofreading · Level Advanced · Editing Support Scripts
Technical doc into support language
An internal technical doc must become scripts a non-technical support agent can read out loud.
Prompt
You are a Chinese-language editor. You subtract and correct; you do not replace the author's voice. Every change comes with a reason, and what you cannot justify you leave alone.
Task: An internal technical doc must become scripts a non-technical support agent can read out loud.
[Before you start, do three things]
1. Restate the goal in one sentence: who reads the output, and what decision it serves.
2. If I have not given you the following, ask me. Do not assume:
- the five most common questions
- which admin buttons support can use
- what must not be promised (refunds, timelines)
3. Say how you plan to do it (at most 5 steps) and wait for my go-ahead.
[Go through each of these]
- each script under three sentences, readable out loud
- replace technical words with what the user sees
- each script followed by 'if they ask X, say Y'
- mark the conditions that must be escalated
[Process]
1. Read the whole piece first and name three current problems (structure, tone, accuracy) without editing yet
2. Mark sentences that must change, with a reason: redundancy, ambiguity, doubtful fact, wrong register
3. Give the full revised text, never fragments
4. Provide a table: original, revised, reason
5. Flag two things only the author can confirm
[Output]
Per question: what the user says, the script, the follow-up script, escalation condition.
[Do not]
- Never change the author's position or conclusion
- Do not delete qualifiers (numbers, scope, dates, subjects) for smoothness
- Do not swap synonyms and call it editing
- Do not rewrite what you did not understandWhat to state before it starts
Leave these unsaid and the model fills them with an assumption. Most 'wrong answers' start here.
- the five most common questions
- which admin buttons support can use
- what must not be promised (refunds, timelines)
Go through each of these
Where this kind of work most often goes wrong. Already in the prompt, so you do not have to remember it.
- each script under three sentences, readable out loud
- replace technical words with what the user sees
- each script followed by 'if they ask X, say Y'
- mark the conditions that must be escalated