Writing & Documents

Writing, document preparation, and editing workflows.

Showing 73–84 of 101 guides

Report quotation checks that preserve the passage's surrounding context and avoid changing its meaning through a cut.
10 min read

Use report quotation checks before citing a passage

A quotation can be letter perfect and still lead a report reader astray. The words might come from a single afternoon observation, while the sentence introducing them claims something about every shift. Before citing a passage, read the quoted words alongside the source, the attribution, and the claim that leads into them. The fictional workplace note below shows how report quotation checks can catch a misleading impression even when no word inside the quotation marks has been copied incorrectly.

Table headers for a report that spans pages, including repeated labels and readable columns when the table breaks across pages.
8 min read

Plan table headers for a report that spans pages

A table that continues onto another page asks more of its labels than a table that fits in one view. A reader may open the later page first, receive only that page from a colleague, or lose sight of the original header while following a long list of rows. The later page should say which table it continues and what each visible column records. Start with the meanings already established by the report, then decide which of those meanings must travel with the rows. Leave the recorded entries alone.

diagram connector routing: drawing connector paths that readers can follow without ambiguity.
9 min read

Plan diagram connector routing for unambiguous paths

A diagram can preserve every intended relationship and still make a reader follow the wrong line. To revise an existing drawing, first record which shapes are supposed to connect. Then trace the visible paths against that record, looking closely at crowded endpoints, crossings, and arrowheads. Move shapes or reroute lines only after you know which connections must remain unchanged. The test is whether a reader can follow each path from its stated origin to its stated destination without mistaking a nearby line for part of it.

Argument mapping guide to connecting reasons, evidence, and a recommendation before choosing a supporting device.
10 min read

Use argument mapping to examine a recommendation's support

A recommendation can sound reasonable before anyone has checked how its reasons connect to the proposed action. Argument mapping gives you a way to mark those connections in a short piece of prose. Start with the author's actual words, name the conclusion, and ask which statements support it alone or only together. Mark any missing connection as a question. The map helps you see what the recommendation still needs; it does not establish that the claims are true or that the action should be taken.

Story point of view guide to keeping a fictional scene’s perspective consistent for the reader.
9 min read

Check story point of view across a fictional scene

A narrator can describe an envelope on a desk without knowing why someone put it there. If a scene is meant to stay close to one character, that difference matters. To check story point of view , take an existing passage and ask who could know each detail as the scene unfolds. Keep the author's intended narrative approach beside the passage. A sentence that exceeds a limited viewpoint might be entirely appropriate in an intentionally omniscient story.

Story tense consistency guide to checking the narrative clock across a fictional scene.
9 min read

Check story tense consistency in a short fictional scene

A scene can move between past and present without anything going wrong. A character may speak about what is true right now while the narrator recounts something that happened yesterday. To check story tense consistency , first decide when the main action takes place in the telling. Then ask whether each change of verb tense signals a real change in time or merely interrupts that chosen frame. The useful question is not whether every verb matches its neighbor. It is whether a reader can tell when each action happened.

dialogue paragraphing: using paragraph breaks to make speaker changes clear in a scene.
8 min read

Use dialogue paragraphing to make speaker changes clear

A conversation can leave a reader guessing even when every spoken sentence is easy to understand. If two characters speak in the same paragraph, or an action sits beside the wrong line, the page may suggest a speaker the writer never intended. Dialogue paragraphing gives each confirmed turn a visible place. The practical task is narrow: keep the dialogue, actions, and their order intact while deciding where one paragraph ends and another begins.

document comment resolution: resolving comments before creating a revised report.
10 min read

Plan document comment resolution before revising a report

Three people have commented on the same workplace report. One wants a sentence explained, another disputes a figure, and a third wants the report to cover a new question. Editing in the order the comments arrived risks turning an unapproved suggestion into a change to the brief. Start by preserving what each person asked, identify the passage they meant, and decide what response is possible before rewriting it. For document comment resolution , verify each step.