Writing & Documents

Writing, document preparation, and editing workflows.

Showing 1–12 of 26 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.

Report summary writing that keeps a completed report's scope, qualifications, and limits intact in the shorter version.
9 min read

Use report summary writing to preserve important limits

A completed report can answer a narrow question carefully while its short summary makes a much broader claim. To prevent that shift, report summary writing should start with the report's actual conclusion, then retain the evidence and limits a reader needs to interpret it. The job is to produce a standalone account of what the report found, not to repeat every section in miniature. A short summary is successful only if a reader who never opens the full report would still understand where its conclusion applies.

Report appendix planning that places supporting material where readers can find it without crowding the main recommendation.
8 min read

Use report appendix planning to place supporting material

A workplace report recommends revising a meeting-room booking process. Its reader needs to understand why the proposal is worth considering and how much confidence to place in the material behind it. The draft has four kinds of text: the recommendation, a short summary of observations, individual observation entries, and a limitation on the period observed. Which pieces belong in the main discussion, and which could move to an appendix?

Workplace correction notice for a report already shared, identifying the wrong room, corrected account, and recipient action.
8 min read

Write a workplace correction notice for a shared report

A report has already reached colleagues when someone spots a wrong room in its account of a completed activity. Editing your own copy cannot tell those readers what changed. They need to know which report they received, where the error appears, what has actually been confirmed, and whether anyone has authorized a change to their work. Send a correction that answers those questions without suggesting the whole report has been checked again.

Writing & Documents Guides | Republeq