108. Humor: the unsignalled smile

The fictional committee has agreed to simplify the form. It has appointed a second committee to decide which of the first committee's questions can go. This is progress, in the sense that there are now two meetings to attend.

The smile comes from following an ordinary intention to an inconvenient result. Nobody has to announce that bureaucracy can be absurd. The committees are attending to that themselves.

This is one way humor can work in prose about work: look closely, follow the reasoning, and leave the reader a small discovery. It is not the only way, and it is not a requirement. A useful page without a joke has suffered no loss.

This chapter teaches how to find and shape those discoveries. It also teaches where to leave them out. The writer can enjoy a sentence while deciding that the reader needs something else.

Notice before inventing

An amusing observation usually begins with something particular: a choice, a label, a discrepancy between the stated plan and the work needed to carry it out. “Software is frustrating” gives a reader little to recognize. A fictional archive containing six folders called old gives the frustration a place to live.

Look for a small contradiction within the material:

• A process meant to save decisions introduces another decision.
• A name promises certainty that the surrounding names withdraw.
• An elaborate explanation arrives at an ordinary conclusion.
• A modest object acquires responsibilities it cannot possibly fulfill.

These are places to look, not facts to assert about a product. The archive is invented. A real claim about a setup process needs the same evidence whether it is delivered solemnly or with excellent timing.

Start with the plain observation. What happened? What was expected? Where do they differ? If you cannot answer those questions, you may have a comic attitude in search of a subject. Keep looking at the subject.

The best detail need not be extravagantly strange. A perfectly ordinary object, described in the wrong amount of official seriousness, can do the work. In a fictional office, a sticky note reading “temporary arrangement” has remained beside the printer long enough to acquire a second sticky note. The second note matters more than an adjective such as ridiculous.

Give the reader an expectation to revise

Surprise needs preparation. The first part of a sentence establishes a pattern; the later part makes the reader reconsider it.

In this fictional office, the filing policy covers names, dates, and the circumstances under which the policy may be ignored.

The first two items invite an orderly third. The third reveals the office's accommodation with actual life. The sentence would lose some of its movement if it began with the exception and then listed dates.

A three-part list is one useful shape. It is not a law of comedy. Two clauses can carry a turn, and a longer paragraph can spend several sentences building the expectation. Use enough preparation for the reader to have something to revise; cut the preparation that merely delays the revision.

For a slower turn, let the narrator reason carefully toward an unexpectedly modest result:

The fictional review procedure gives every department a chance to comment, provides a place for dissent, and records the reasons for each decision. It has not yet established who sends the email.

The account remains calm. The contrast between comprehensive preparation and the missing practical step supplies the humor.

Do not hide a deadline, exclusion, charge, or irreversible consequence to create this effect. An essay can postpone a harmless observation. A decision page must disclose the terms when the reader needs them.

Keep the delivery steady

A dry line usually uses the same voice as its neighbors. It does not become louder, ask for credit, or explain that the writer is being amusing.

Compare these versions of an invented situation:

Announced: In a hilarious twist, the “brief” agenda now has an appendix!

Steady: The brief agenda has an appendix.

The second gives the reader room to notice the mismatch. It can be read as a plain report, and the report remains accurate within the example.

Removing a signal does not automatically create a good joke. A dull observation remains dull without its exclamation mark. What the edit removes is the demand that the reader agree with the writer's response.

Watch for funnily enough, you have to laugh, explanations in parentheses, and comments celebrating the line you have just written. Sometimes an exclamation mark belongs to the surrounding voice; punctuation alone does not diagnose the problem. Read the passage for whether it reports an observation or supervises the reader's reaction.

After the turn, continue the thought. A paragraph break can give a short observation room. Another sentence may supply necessary explanation. “Nothing may follow the joke” is too crude a rule for prose: the requirement is to avoid explaining the humor or competing with it, while still finishing the reader's work.

Use precision without manufacturing evidence

Particulars help readers see a scene. They also carry an implied claim that someone knows them.

“The meeting ran long” is vague. “The meeting occupied the entire lunch break” places the cost within familiar experience. Either may be true; neither becomes permissible because it is amusing. A precise invented duration in a real account is still invented.

In an explicitly fictional example, you can choose a detail for its rhythm and relevance. In a case study, choose from the details you have permission and evidence to use. If the only supported fact is that a review required several rounds, do not give it seventeen rounds because seventeen sounds more comic.

The detail should help the reader understand the situation as well as sharpen it. A sample filename can reveal the purpose of a duplicate:

For the practice file, use poster-before-the-third-opinion.svg.

That may suit an essay about design reviews. In a procedure teaching filename syntax, the same name may distract from the syntax. The fact that a sample is invented gives you freedom to choose its content, not freedom to obstruct its teaching job.

Let comparisons illuminate one relation

An analogy can create a smile by treating a familiar task with disproportionate seriousness. It must still clarify something.

Suppose a fictional essay compares a vague cross-reference with a sign that says “Somewhere this way.” The comparison explains the problem: direction without a usable destination. It does not claim that links and road signs share every property.

Name the relation before developing the analogy. Are you explaining selection, repetition, hidden effort, or a mismatch between promise and result? Keep the parts that serve that relation. Leave the rest of the imagined machinery out.

Be especially careful with personification around software. “The file has declined to explain itself” might be a harmless literary description of an opaque name in an essay. It would be poor diagnostic text for a failure to open the file. A reader looking for the cause needs the observed failure and any supported next step.

When the comparison could be mistaken for a mechanism, state the mechanism plainly or remove the comparison. Charm does not establish how a feature works.

Make a callback change the meaning

A callback returns to a detail the reader already knows. Repetition provides recognition; a changed context gives the recognition a purpose.

The opening committee can return near the end of an essay when the writer discusses review. It should return because the new passage reveals something about the first situation, not because the writer has reserved a joke-shaped parking space there.

For example, an essay might begin with that committee trying to simplify a form. Later, after explaining how to choose a responsible owner, it could observe that the second committee now has someone to send its questions to. The return connects comic setup with practical resolution.

Each appearance should work locally. Readers may arrive through a section link, and a product journey may skip the screen where a detail first appeared. Do not make the instruction depend on remembering a private exchange from six pages ago.

Remove a callback that repeats the first joke without developing the thought. Recognition alone can earn a small smile; repeated demands for recognition become attendance checks.

Choose the reader's moment

An essay reader with time to explore can enjoy a digression. A reader facing uncertain loss cannot be assumed to share the writer's distance from the problem.

Use the surface and the reader's state together:

Surface or situation	Editorial choice
Essay, teaching chapter, unhurried introduction	A relevant observation, analogy, or short comic scene may help the thought develop.
Fictional example or sample data	A dry detail can be useful if it preserves the lesson and remains clearly illustrative.
Ordinary first-use empty state	Establish what is empty and the supported next action; consider whether any extra line earns its space.
Controls, labels, procedural steps	Give the recognizable name or action. Keep optional humor out of the route.
Error, failed payment, account access, possible loss	State known facts, limits, and supported action plainly.
Pricing, licensing, legal terms	Make the commitment and conditions explicit. Do not require interpretation of a joke.

An empty list is not proof of a harmless first-use state. It may also reflect a loading failure, permissions, or missing records. The writer must know which state the interface actually represents before writing a welcome line.

A humorous introduction also needs this judgment. Its position at the top of the page does not tell you whether the arriving reader is relaxed.

Choose a target without contempt

The reader should not have to accept an insult to receive the help. Jokes about stupidity, nationality, language ability, disability, or a customer's supposed incompetence are poor foundations for a working relationship.

Shared work offers plenty of other material: the growing review process, the ambiguous filename, the instruction whose cross-reference returns to its own page. Describe the condition closely enough and you need not make a person foolish.

Self-deprecation can work, but it has limits. A writer admitting to an untidy desk is one thing; a service joking that it cannot be trusted with files is another. The second undermines the very assurance the reader may be trying to assess.

Nor does membership in a group give a writer universal permission to mock it. A reader cannot be expected to know the writer's biography or accept the joke on behalf of everyone else. Review the actual line, the actual audience, and the actual situation.

Warmth often survives after the joke is removed. Paying attention to a reader's repeated task can be more companionable than commenting on how tiresome the task must be.

Keep the literal meaning usable

Read the line as someone who misses the irony. What would that person believe about the task?

“This operation never fails” is an unsafe joke in instructions if the operation can fail. A deadpan tone will not rescue the statement. A reader may understand it literally, translate it mechanically, or arrive directly at the sentence without the surrounding essay.

A fictional account of a brief agenda with an appendix has a different structure. The appendix is part of the given situation. Missing the smile does not change what the reader understands happened.

This literal-reading test also applies to repairs. Suppose the only evidence says an export could not be located. Replacing “Your export has gone exploring” with “The app saved it in your previous folder” invents a cause and a destination. A plain sentence can be just as false as a joke.

A supported repair is narrower:

The export could not be located.

Add a destination or recovery step only when the supplied information supports it. The repair may need further facts before it is useful enough to publish. Preserve that gap in review instead of filling it with confidence.

Check what translation must carry

A joke based on two meanings of one English word may have no equivalent in another language. A cultural reference may exclude readers who understand every word. A visible contradiction can require less background knowledge, although no comic pattern travels automatically.

Write the plain meaning beside a candidate line. Then identify what produces the turn: wordplay, rhythm, a shared situation, an object, or knowledge of another text. This gives a translator or reviewer something concrete to assess.

Do not treat a rough paraphrase as localization validation. It is an early check. A translator may find that the example needs different wording, a different illustrative detail, or no joke at all. Preserve the instructional meaning while making that choice.

Accessibility brings a related test. If the surprise depends on visual position, color, or an image, consider how the information reaches someone using another presentation. Essential instructions need a usable route regardless of whether the humor survives.

Draft alternatives, then edit for the page

Begin with a factual or explicitly fictional packet. Write the plain meaning first. Draft a few different approaches without making the first successful line the owner of the paragraph.

For this invented example, the packet is small:

• An office calls its weekly planning document a brief agenda.
• The current agenda includes an appendix.
• No duration, page count, or reader reaction is supplied.

Possible approaches include a straight report, a restrained observation, and a longer setup:

Plain: The weekly agenda now includes an appendix.

Dry: The brief agenda has an appendix.

Developed: The office keeps its weekly agenda brief. Additional material is placed in the appendix, where brevity does not have to look at it.

The last version personifies brevity within an explicitly fictional office scene. It suits an essay better than operational documentation. The middle version needs less space. The first may be the right choice when the appendix itself is what the reader needs to find.

Try moving “appendix” to the beginning of the dry version. The fact survives, but the contrast arrives before the expectation has settled. Restore the order if the gradual discovery serves this paragraph. This is a timing decision, not a rule that every surprising noun must end a sentence.

Notice what none of them adds: a meeting duration, a page count, or evidence that colleagues enjoyed the arrangement. The literary treatment changes the angle and rhythm, not the factual packet.

Compare alternatives in their surrounding paragraph. A line can work beautifully alone and interrupt the page it was written for.

Review the whole journey

A dry aside on one page may be unobtrusive. The same degree of performance in the welcome screen, tooltip, confirmation, receipt, and follow-up message can make the product feel as though it is always waiting for a reaction.

Read the sequence the reader is likely to encounter. Mark where each comic line asks for attention and where the reader's stakes change. Remove lines that repeat an effect, delay a decision, or arrive after the reader needs a plainer voice.

There is no useful universal quota of jokes per document. Length, purpose, density, and audience vary. Restraint means choosing the lines that help the piece, not counting to two and declaring the remaining paragraphs safe.

For review, ask what the line communicates literally, who or what it targets, and whether the next action remains clear. Record concrete feedback when available. “A reviewer understood the instruction but missed the joke” is different from “a reviewer could not identify the action.” Neither observation proves how all readers will respond.

Practice: keep the thought, change the treatment

Use the agenda packet above to write a short teaching paragraph about document scope. First write it without humor. Then add one of these moves: an expectation followed to an inconvenient conclusion, a precise physical detail supported by the packet, or an analogy that explains the scope problem.

Read both versions aloud. Identify the sentence where the reader's understanding advances. If the comic version merely adds another sentence after that point, try integrating the observation with the explanation or remove it.

Now adapt the paragraph into a navigation label and a message reporting a missing agenda. Use the supplied facts only. The label should name its destination. The missing-document message must not diagnose deletion, invent a recovery path, or borrow the essay's amusement.

Finally, remove the appendix from the packet. Every version that depends on it must change. This is the factual discipline beneath the stylistic freedom: a clever sentence has no special claim on a fact that is no longer available.

Checklist

• The humor begins with a relevant observation, not a demand to sound witty.
• The setup gives the reader enough context to recognize the turn.
• The delivery leaves the reader free to notice or miss the smile.
• Particulars are supported or clearly fictional; no number, cause, or outcome was added for effect.
• Analogies explain a relation without impersonating product behavior.
• Callbacks develop the thought and do not carry essential instructions.
• The literal reading remains accurate and useful.
• The target and placement respect the reader's current stakes.
• Translation and alternative presentations retain the instructional meaning.
• The surrounding paragraph and the complete journey improve with the line present.

The committee can review those points. One meeting should do.