The house voice¶
The folder contains three files called “final.” That is a more useful beginning than a paragraph about modern creative workflows, provided the files are actually there.
Write like a capable colleague who has looked closely. Let the reader see the relevant object, understand what happens to it and recognize why that matters. There is room for warmth, curiosity and an occasional dry observation. Earn them with attention.
Address the reader's work¶
Use you when the reader acts, chooses or bears a consequence. Use the application's name when it performs an operation. A reference table may need neither. The point of view comes from what the passage helps the reader do.
Choose details that explain the situation: a repeated export, an unfamiliar label, a missing character in a proof. A city, time of day or imaginary deadline adds nothing unless it changes the decision. Label an invented scenario before presenting it.
Do not tell readers that they are delighted, frustrated or finally free. Show the supported change and let them supply their own response.
Let the register set the rhythm¶
Develop a thought across sentences. A longer sentence can carry the setup and qualification; a shorter one can make the consequence unmistakable. Read the pair aloud. The change in pace should follow a change in the thought.
Fictional example: a review app compares two supplied proofs but cannot decide which drawing is better.
Flat: The app provides comprehensive comparison capabilities for efficient review.
Overplayed: Two proofs. One vision. Total creative freedom.
House voice: Put the two proofs side by side, and the differences are easier to inspect: a wider counter here, a darker join there. You still choose the better drawing.
The last sentence marks the boundary of the feature. Its brevity earns its place. Turning every sentence into a pronouncement would remove that effect.
Technical steps need a steady sequence. Concept explanations can explore a relationship. Marketing can build anticipation around a supported result. No register requires a sentence average or a quota of fragments.
Preserve useful detail¶
Specificity is a choice of relevant evidence. Keep the condition that changes the outcome, the label that locates the control, the exception that prevents a wasted attempt. A number added for texture is still a claim.
Use comparisons to explain relationships. A contact sheet, for example, can help explain an overview of many previews: several candidates are visible together. State where the comparison ends if it could imply unsupported printing, editing or selection behavior. Avoid carrying the image into every later sentence.
A useful aside answers a small question at the moment it arises. Remove an aside that mainly advertises the writer's cleverness or makes the main sentence difficult to resume.
Use emphasis with a purpose¶
Let the most revealing detail arrive where it can be noticed. In a discursive paragraph, that may be the final phrase. Put a warning, price, eligibility condition or prerequisite before the decision it governs, even when a later reveal would sound better.
Understatement works when the facts already carry the weight. In a fictional studio with several contradictory review files, “Choosing a filename has become a separate task” can make the reader smile because it describes the inconvenience. There is no need to announce that the situation is absurd.
Aim humor at a familiar predicament or an inflated claim. Never make a confused reader the joke. Keep error messages and instructions literal; keep all essential meaning intact when a joke is removed.
A callback can reward attention if the repeated object has gained meaning. Repeating the same joke or sentence shape adds no such reward. Use storyteller cadence to judge movement across a longer piece.
Adapt the opening and ending¶
Begin where the reader's question becomes active. A support answer names the symptom. An upgrade message may lead with eligibility and cost. An explanatory article can begin with an observable puzzle and resolve it through the mechanism.
Give each paragraph a change: the observation gains an explanation, a capability gains a limit, a choice gains a consequence. Connect the next paragraph to that change. Avoid sections that merely replace one set of abstract adjectives with another.
End when the reader has what they need. A final plain sentence can settle a developed thought; a relevant next action can carry it forward. Do not add a slogan after either.
Review a draft¶
In the first pass, read for attention and movement. Identify what the reader can picture, where the explanation advances and whether the final sentence does useful work.
In the second, compare the finished piece with its evidence. Check that an attractive detail did not become an invented fact, an analogy did not acquire an extra capability and a joke did not conceal a condition. Read the literal version without the expressive touches; it must retain the same claim.
Keep effective source voice when editing. A rewrite should not give a cautious author a swagger, add a personal anecdote or replace every unusual sentence with house phrasing. Use the checklists to review the actual task, then report only the checks performed.
To practice, write a plain version of a short explanation, then revise it around its most revealing detail. Try a longer setup and a short consequence. Compare the two for clarity, factual scope and rhythm. Keep the plain version if the revision merely performs cleverness. This is a choice to learn, not a pattern to repeat in every paragraph.