Revision Plain Letter

Use one name for the same thing

A document can become harder to follow when one object receives several names for no useful reason. A form becomes an application, then a request sheet, and the reader starts wondering whether three different items are involved. Before standardizing the wording, identify the actual thing each term refers to. Some differences may be deliberate: an application may contain several forms, and a request may be an action rather than a document. The editing task is to remove accidental variation while preserving real distinctions. A search-and-replace operation cannot make that judgment on its own.

Begin with a small list of important names in the draft. Include documents, groups, locations and repeated actions that the reader needs to recognize. For each one, write a plain description of its referent in your working notes. In an invented booking guide, room request form might mean the actual document a visitor completes. Approval notice might mean the separate response. Those descriptions make it easier to decide whether two phrases refer to the same object. They also expose a draft that uses one term for different things, which is a different problem from using several terms for one thing.

Choose a preferred name that the intended readers will recognize and that matches any verified official title where accuracy requires it. Do not invent a friendlier title for a real document if the reader must find it under another name. You can introduce the formal title once and use a short, clear reference afterward, provided the connection remains obvious. Keep capitalization appropriate to the actual name. Giving a generic phrase a capital letter in every occurrence can make it look like a formal title and suggest a status it does not have. Naming choices should help identification, not manufacture authority.

Search for likely alternatives and inspect each occurrence in context. A word such as request may refer to both a document and an ordinary action, so changing every occurrence could produce nonsense. Read the complete sentence and, when necessary, the paragraph around it. Mark uncertain cases for clarification rather than settling them silently. If the draft distinguishes a draft application from a submitted application, keep that status visible. Standardization should not erase a stage in the process or make an incomplete action appear complete simply because the shorter term looks cleaner across the page.

Check headings, captions and link labels as well as the main paragraphs. A page may use the preferred term consistently in prose while its navigation calls the same destination something else. Sometimes a shorter navigation label is necessary, but the destination should still be recognizable. Compare the actual linked page or document with the wording. Do not assume that matching labels validate the underlying information. The naming pass can reveal an outdated title, a moved file or an unresolved distinction. Those findings need truthful correction and, where appropriate, confirmation from whoever maintains the material.

Keep useful variation when it prevents an awkward repeated name and the reference remains clear. After identifying the room request form, a later sentence may reasonably say the form. The problem is not every change in wording; it is variation that suggests a new referent or hides the existing one. Read a sequence of mentions and ask whether the reader can follow the object without looking backward unnecessarily. A pronoun may work in one sentence and fail in the next because another document has entered the discussion. Choose the reference according to that local context, rather than applying a rigid naming pattern throughout.

Finish by checking the document from its first important mention to its last. Confirm that the chosen names still describe the right objects and that any deliberate distinctions remain visible. Retain a short terminology note if the document will be revised repeatedly, but do not create an elaborate glossary for a page with only two recurring items. The useful result is a stable set of references. Readers should be able to recognize the same thing when it returns and notice when the text genuinely introduces something different, without mistaking ordinary word variety for an unexplained change in the subject.

Continue reading

Read the draft, then name the snagCut repetition without losing emphasisMore in Revision