309. The marketing voice: wit, taste, honesty¶
“Complete creative freedom” makes a generous offer. It leaves a few practical questions unanswered: freedom to do what, with which material, and what happens when the file is exported? A paragraph can sound expansive while giving the reader very little room to act.
The house voice takes an interest in the work. It notices a setting worth changing, a comparison worth making, a small distinction that explains a large claim. It can enjoy those details without applauding the reader for arriving. Precision gives the warmth somewhere to live.
Wit, taste and honesty influence the whole passage. Wit notices a relationship. Taste judges whether it belongs here. Honesty keeps the resulting sentence true. None requires a compulsory joke, a ritual confession or an adjective count.
Give the voice something to notice¶
Consider this fictional preview app:
- It shows a chosen sentence in a selected font.
- A Size control changes the preview size without changing the source document.
- It has no automatic readability assessment.
- Its free viewer cannot export a specimen.
A general promise supplies little of that:
Transform your typography with effortless precision and total confidence.
A more useful introduction can also have more character:
A sentence can look settled until you see it smaller. Change Size to inspect the preview at another scale; the source document stays as it was. The viewer gives you a different view, while the judgment remains yours. Specimen export is unavailable in the free viewer.
The paragraph begins with something to investigate. Its middle connects the control to its scope, and its final statements establish responsibility and the edition limit. It does not need to instruct the reader to feel excited.
For a notice beside the control, shorten the treatment:
Size changes the preview size. It does not change the source document.
Both passages can belong to the same company. Their jobs differ. The longer one makes room for attention; the notice resolves a local question.
Warmth is attention to circumstances¶
Warmth can come from recognizing a real difficulty, giving an example at the right point or explaining a distinction without making the reader feel examined. It also comes from patience: allowing a thought to develop rather than pushing the reader toward the next button in every paragraph.
Avoid medals for ordinary behavior. “You are a visionary” tells someone little about the product. “You are smart to compare” makes an unsolicited judgment about them. Show the comparison and explain what it can establish.
Use the reader’s circumstances only when they are supplied or clearly hypothetical. Do not invent a late night, a difficult client or a history of frustration to manufacture intimacy. A conditional opening can be both plain and companionable:
If the caption will be small, inspect it at that size before making your choice.
This gives a reason to look. It does not claim that the writer has watched the reader struggle or knows how they feel.
Company actions can convey care when they are real: an accessible example, a clear correction, an answered support question. Describe what happened. Do not convert the existence of a help page into a claim that every customer receives personal assistance.
Let the sentence develop¶
Specificity alone does not give a paragraph a voice. A list of exact feature names can be as inert as a list of compliments. Connect the facts through a question, action or consequence.
For the fictional viewer, a draft may say:
Choose a sentence. Choose a font. Change Size. View the preview. Keep control.
A developed version gives the sequence a purpose:
Choose a sentence and a font, then change Size to inspect the same words at another scale. The preview changes; your source document does not.
The repeated subject helps the reader follow what changes and what stays fixed. The last sentence lands because the preceding sentence has established the action. A string of short sentences would not automatically create that effect.
Use a longer sentence when a relationship needs room. Keep its subject and direction clear, and place qualifications beside what they qualify. Follow with a short sentence when there is a distinct consequence to settle. See chapter 310 for passage-level revision.
Judge words by their work¶
Evaluative words need scrutiny, but nouns and numbers are not innocent merely because they look factual. A fabricated count is no improvement on a vague superlative. An exact command can be wrong for the stated version.
Ask what supports the claim and what the reader will understand it to mean. “Fast” needs a relevant basis; a timed comparison needs its method and conditions. “Editable” needs the kind and scope of editing. “Free” needs the terms that affect the proposed use.
Keep descriptive adjectives that distinguish the subject: a small caption, a read-only list, a dark background. Keep abstract terms where they name the actual concept. The task is to explain, not to strip the language until every sentence resembles a button.
For numbers, retain the unit, baseline and justified precision. Calculate from unrounded inputs where available, then round appropriately for the claim. Resolve conflicting figures by definition and method. Choosing the smaller one does not make it accurate.
When a noun hides an action, recover the actor:
Vague: Preview-size modification enables document preservation.
Direct: Change Size to resize the preview without changing the source document.
The direct version names the control, action and boundary. Ordinary articles, relative pronouns and repeated nouns are useful when they prevent guessing. Compression should not charge the reader for the words it saves.
Find humor in the relationship¶
A small contradiction can be enough. Suppose a fictional screenshot review
contains three files named final, final-2 and final-3, and the team has
selected final-3 for publication:
Three files were final. The review selected one.
The dry turn comes from the supplied names and the plain consequence. The reader who does not smile can still follow the fact. In a real account, verify those names and the selection; in a teaching example, identify the invention first.
The same joke does not belong in a file-recovery message. Someone trying to recover work needs file names, status and supported action. The company’s amusement would be an additional burden.
Humor can arise from literal detail, proportion, an unexpected but accurate comparison or a later return to an earlier object. It need not arrive after a fixed number of facts, and a piece need not contain a set number of jokes. Judge the placement by what the reader knows and needs at that point.
A callback must remain understandable. If final-3 returns later as the file
that actually shipped, its status has changed. Repeating the line without a
new consequence simply asks for the same laugh again.
Keep prices, license conditions, errors and recovery literal. Avoid ridicule of customers, their knowledge, finances or deadlines. Sarcasm can reverse the apparent meaning when missed; wordplay can depend on a language-specific accident. Neither should carry information required for a decision.
Use a comparison, then return to the work¶
An analogy can make a relation easier to inspect. It should also have a stopping point. A preview may be compared with looking at a document through a different magnification: the view changes, the source remains unchanged. That comparison does not establish the app’s rendering method or guarantee what will appear in print.
Name the actual control and behavior before the reader acts. If a metaphor creates an expectation the product cannot meet, repair or remove it. Do not stretch a promising image across unrelated features merely to maintain a theme.
Warmth can survive without figurative language. A careful account of what someone can inspect is often enough. The writer’s interest is more durable than a costume of enthusiasm.
Keep your manners when the answer is no¶
The voice matters at a limitation as much as at a feature introduction. Give the answer and any supported next step without disguising the condition.
For the fictional viewer:
Question: Can I export the specimen from the free viewer?
Answer: No. The free viewer cannot export specimens.
The packet gives no paid-edition behavior, price or upgrade route. Do not append a purchase instruction until those facts exist. A complete answer can be short.
Use the same discipline for unsupported platforms, delays, corrections and compatibility. Describe the known scope. A workaround is not official support; a planned change is not a completed fix. State what changed only after it did.
For comparisons, explain the reader’s task and the relevant differences. A fair recommendation need not praise every alternative equally. It does need a basis beyond making another company sound foolish.
Make commercial terms legible¶
A genuine deadline can be stated with its date, time zone, eligibility and terms. Do not turn an ordinary offer into a fabricated emergency or use a timer that restarts while claiming the offer has ended. Digital delivery does not itself prove that every kind of capacity is unlimited; any scarcity claim still needs its actual basis.
Explain fit without grading the buyer. “For serious designers” may flatter one reader while excluding another for no useful reason. Name the work the product supports and the requirements it imposes.
Do not use fake endorsements, unapproved quotations or an anonymous chorus to supply praise. First-person promises belong to the person or organization that can make them. A friendly sender name must correspond to the actual sender and reply arrangement.
A click measures a click. It does not excuse a misleading offer or show that the reader understood the terms. Review those terms before comparing performance.
Revise for evidence, movement and international clarity¶
Use three complementary readings. Their order can follow the draft’s weakness; none is a substitute for the others.
Evidence: Put claims beside their sources. Check version, scope, agency, quantities and current terms. Mark unresolved facts in the working draft; resolve or remove them before publication. Interpretations should remain recognizable as interpretations, with enough basis for the reader to assess them.
Movement: Follow the reader’s attention. What appears, what changes, what does the next sentence help them understand? Replace repeated praise with a relevant detail or connection. Give a useful thought room rather than mechanically cutting all long sentences. End where the promise is fulfilled.
International clarity: Check idioms, pronouns, cultural assumptions and wordplay. A reader may know a difficult technical term while finding an everyday idiom obscure. Keep necessary terminology, explain unfamiliar concepts and preserve syntactic cues. Read aloud for rhythm; reading aloud alone does not verify meaning for another language community.
The voice should remain recognizable through its attention and judgment. A sentence does not fail simply because a competitor could truthfully use it. Common facts and standard instructions belong in clear prose. Add specificity where it changes what the reader learns.
Repair patterns instead of diagnosing authorship¶
A draft full of grand verbs, evenly padded sections and ritual conclusions may need editing. Those patterns do not establish who or what wrote it. Identify the actual problem: missing action, unsupported claim, monotonous rhythm, concealed condition or a paragraph that never reaches its point.
Keep a review list of recurring problems with reasons and repairs. Avoid turning it into a word blacklist that forces less accurate synonyms. “Unlock” can describe an actual lock; it becomes evasive when it disguises a license condition. “Robust” needs a stated meaning and basis if it carries a product claim.
Prompts need positive instruction too. Tell the writer what to notice, how to connect a paragraph and where restraint helps. A list of forbidden words cannot supply the subject of a sentence.
Practice a voice that can answer back¶
Use this new fictional packet: a proof viewer places two supplied pages beside each other. It does not mark differences or choose a preferred version. The viewer is read-only. No export behavior or offer terms are supplied.
Write a short introduction that invites the reader to inspect one detail across both pages. Then answer “Will it find the differences for me?” Keep the voice recognizable while changing its pace for the direct question.
A possible introduction and answer:
Introduction: Put the two pages beside each other and follow a detail from one to the other. The read-only viewer gives you both pages to inspect; it does not mark differences or choose a preferred version.
Answer: No. The viewer places the pages beside each other, but you identify the differences yourself.
The introduction invites sustained attention and joins the arrangement to its limit in a developed sentence. The answer drops the invitation because the reader has asked a direct question. Both retain the same division of work. “Catch every change” would add a guarantee neither the app nor this example can supply.
On the second pass, replace a general promise with an observable arrangement. Carry the same detail from one sentence to the next, and let the paragraph end when the division of work is clear. Remove any claimed result that depends on judgment the software does not perform.
Leave a useful review record¶
For substantial copy, record the main reader decision, evidence, material terms and unresolved questions. Note a sentence changed for accuracy and one changed for voice. This keeps the review from remembering confidence as proof.
Ask what misunderstanding the draft could pass to the next person: a buyer, a translator, support or the writer of a tutorial. Repair the sentence where the misunderstanding begins.
Finally, read the piece without its most conspicuous flourish. If the information becomes clearer, revise the flourish. If a useful connection disappears, see whether the image expressed that connection accurately. Personality has a place in the explanation. It has to earn the same scrutiny as everything else.