Archive for November, 2019

h1

Lessons learned from a corporate report

November 30, 2019

I recently did a few editing passes on a 640+ page environmental report that was to be submitted to a federal regulatory authority. I wasn’t able to fully edit the report, but I was able to tame the formatting issues in Word (including making sure all tables had a similar look), check for inconsistencies in common terms and phrases, fix the cross-references to other sections/figures/tables/appendices, check the abbreviations/acronyms list reflected the abbreviations used in the document, ensure nonbreaking spaces were used between values and units of measure, etc. There was no corporate template or style guide to use (the company is very young), though someone had put a very basic template together—cover page, headers/footers and the like—but hadn’t set up styles, therefore the formatting of bullets, numbers, body text etc. was all over the place. Multiple authors had worked on this report, and each had done something a little different with their formatting, and varied in the terms they used and whether they capitalised or hyphenated them or not.

After I returned the document to my contact, she asked if there were some ‘lessons learned’ that she could share with her boss and others involved in the document. Here’s a summary of the email I wrote to her:

  1. Template: Get a corporate report template in place, with as many necessary styles in it and sample tables set up ready to be copy/pasted and modified. Learn how to use it and WHY you should use it.
  2. Style guide/sheet: In the absence of a full style guide, set up a corporate style sheet that lists the preferred ways of spelling/using terms (e.g. the correct spellings/hyphenations for place names, words that can trip you up – e.g. wellhead/well-head/well head, tophole/top-hole/top hole). Make your authors use it, and that you forward it to whoever edits your docs so that they can follow the decisions already made.
  3. Styles:
    • Discourage writers from using the buttons on the Word toolbar for bullets and numbers (there be dragons!) – use the relevant List Bullet and List Number styles
    • Learn how to apply styles to new text, and how to paste text from another doc and format it correctly (NEVER copy across section breaks, for example – more dragons lie there!)
    • Learn how to apply table formatting/styles – for example, in the [company] doc there’s a special button on the Table Tools > Design tab for applying the green table, but I wonder how many know how to use it and instead spend ages setting up the borders, shading etc. manually.
  4. Clickable cross-references (x-refs):
    • In the absence of a program like EndNote, learn how to do x-ref numbered citations so you don’t end up with [CorporateAuthor] 2019a, 2019b, 2019c etc. This sort of citation is a nightmare to update
    • Learn how to assign x-refs (clickable links are recommended for anything that’s going to be PDF’d and read on screen).
  5. References: Make sure authors are CONSISTENT in doing references, specifically when to apply italics, what punctuation to use, how to indicate when a URL was valid etc. (a style guide would help here). I didn’t check any for accuracy, but verifying references online is a BIG job to do after the fact—far easier for the author to grab ALL the citation details when they are writing the doc.
  6. Terms: Make sure authors are pedantic about adding initialisms/acronyms/abbrevs, units of measure etc. to the relevant terms lists—it’s easier to check if something is there or not than to create the list from scratch after writing the doc. I use software macros that can pull out some of this, but not all.
  7. Unlearn/break bad habits that work for university but not for business/corporate writing. Think like a business person with limited time and NOT like a uni researcher! The habit of writing to a word or page count has been ingrained since about Year 5 and reinforced all the way through to doctorates and, later, journal and other publications. Business reports need to be succinct, use plain language, and get to the point in as few words as possible, without losing meaning. Some examples of bad habits:
  8. Learn new habits: e.g. keyboard shortcuts for things like nonbreaking spaces (Ctrl+Shift+<spacebar>), turn on/off track changes (Ctrl+Shift+e), add a comment (Ctrl+Shift+m), change case (Shift+F3).

I also mentioned and linked to presentations I’ve given to government departments, editors groups, and conferences on plain language writing and on working more efficiently with Microsoft Word (http://cybertext.com.au/presentations.html).

h1

Word: Find text with angled brackets and replace the text with a character style

November 2, 2019

Here’s one I heard of today, and how I solved it. The person has a Word document with various words and phrases surrounded by double angled brackets, as in <<this is my phrase>>. They want to apply a character style to any text surrounded by angle brackets, and delete those brackets.

I always like a challenge like this, so here’s my solution:

  1. Press Ctrl+H to open the Find and Replace window.
  2. Click More.
  3. Select the Use wildcards checkbox.
  4. In the Find what field, type: (\<\<)(*)(\>\>)
  5. In the Replace with field, type: \2
  6. Click Format, then select Style.
  7. Choose the character style you want to apply (character styles are indicated with a lowercase ‘a’ to their left), then click OK.
  8. The character style’s name should be listed directly underneath the Find what box—make sure that this is the case.
  9. Click Find Next, then click Replace if you are satisfied that the correct phrasal structure has been selected.
  10. Assuming that replace worked as you wanted it to, and you are confident the result looks as you expect, click Replace All. (If in doubt, keep clicking Find Next, then Replace.)

How this works:

  • The Find is broken up into three elements, each surrounded by parentheses:
    • The first element contains the opening two angled brackets.
    • The second contains an asterisk wildcard character for any character and any number of characters.
    • The third contains the closing two angled brackets.
  • In the first and third elements of the Find, the angled brackets are each preceded by a \ because an angle bracket is a special character in wildcard searches and therefore must be ‘escaped’ so that Word treats it as a normal character. The ‘escape’ character is the \
  • In the Replace, \2 tells Word to replace the second element (the text and all characters between the angled brackets) with itself (i.e. make no changes), and to apply the character style you chose to that replaced text.
  • By omitting \1 and \3 in the Replace (representing the first and third elements of the Find), Word will effectively delete the opening and closing angled brackets.