The Editors' Weekly
Official blog of Canada's national editorial association
The Editors' Weekly
Navigation
  • About the Blog
  • Contact Us
  • Articles en français
  • editors.ca
  • reviseurs.ca
You are here: Home › General EAC › Standards at Work: Technical Editing
← Winning in the Freelance Game
Interview With Dr. Suzanne M. Steele →

Standards at Work: Technical Editing

November 20, 2018 | Filed under: General EAC, Standards Communication Task Force and tagged with: editing, editing standards, Ellen Lupu, formatting, instruction manuals, Professional Editorial Standards, Shelley Egan, Standards at Work, technical editing, technical editor, training manuals

Editors Canada’s Professional Editorial Standards (PES) describe the responsibilities of an editor. The scope of PES is broad; this series explores how the standards apply to a variety of editing contexts.

user guide document on table book manual

Bakhtiar Zein © 123RF.com

Ellen Lupu has been a technical editor for 12 years. Her current project involves writing and editing training material for an oil and gas company.

She and her team of five professional writers and a subject matter expert work remotely, and Ellen has met just one of the other team members. They communicate by phone and email and meet online. Of standard A6.5 — “[B]e familiar with software commonly used for design, formatting, electronic publishing, and web authoring” — she says, “For remote editing, this standard is key: the writers write their manuals using online authoring software, and I edit the manuals in PDF form using online markup.”

She stresses the importance of good relationships and of standard C15: “Clearly and diplomatically, request clarification of meaning and intent, explain changes as appropriate, and propose or negotiate significant editorial changes.”

Ellen is responsible for the project style guide but also consults the online Chicago Manual of Style, chosen because it’s comprehensive and easy to search. Her use of these guides relates to standard A10.3: “Know where to find and how to use current, reliable reference works such as style guides, dictionaries, and databases.”

A big part of her job is aligning the team’s work. With her “higher-level view,” she ensures consistency within each manual and across all the books, per standard D8: “Identify and consistently apply editorial style.” For example, for new diagram captions, the team had to decide which format to use: “Generator G-123 (Phase C)” or “Phase C Heater H-45.”

Ellen once worked in traditional print magazine publishing but now uses hard-coded publishing software that deals with formatting issues. She says, “The priorities are different. The text falls where it falls.” Inserting hard breaks to avoid widows and orphans is taboo, e.g. because text that looks good on a desktop screen or in a PDF may not display properly on a mobile device, and content could be repurposed in the future. Understanding the content’s single-source, multipurpose nature involves standard A1.4: “Understand the different types of publications and media and the implications these have for editing and production choices.”

Because the software sets the training manual structure, Ellen has had to apply a structural editing standard just once, standard B2: “Reorganize material to achieve a coherent structure and sequence, a logical progression of ideas, and a narrative or expository flow and shape appropriate to the audience, medium, and purpose.” In this case, additional pieces of equipment had been added over time, so her team restructured a chapter designed for just one piece of equipment to accommodate multiple pieces.

Although Ellen says she isn’t “a perfect stand-in” for the trainees who will use the manuals, she imagines being one of them while editing. This involves standard A2: “Know the importance of the audience and the purpose of the material.”

And knowing the audience and purpose is key to clarity. She often applies standards C1, C2 and C3, which concern “more effectively convey[ing] meaning” by improving sentence and paragraph construction and word choice. For example, she ensures that, whenever possible, manuals use the active voice, simple sentences and simple language.

Do you edit technical material? Or do the standards mentioned apply to your editing of other genres? Please comment and tell us how!

__

Previous post on the PES: Standards at Work: Fiction Editing.

The Editors’ Weekly is the official blog of Editors Canada. Contact us.

Did you like this article? Share it with your friends!

Tweet

Written by Shelley Egan, Standards Communication Task Force

Find Editors Canada's Professional Editorial Standards on Twitter at @ProEdStandards. The Standards Communication Task Force is Shelley Egan, a freelance editor and proofreader who lives in Fredericton, New Brunswick; Elizabeth d’Anjou, an editor and instructor of editing who lives in Picton, Ontario; and Amy Brown, a Toronto-based freelance academic editor-turned-coach.

← Winning in the Freelance Game
Interview With Dr. Suzanne M. Steele →

What we’re talking about

Aaron Dalton author-editor relationship authors book editors book publishing business practices communication communications copy editing editing editing tools editor editor's role editor advice editorial skills editors editors at work Editors Canada conference français freelance editors freelancing French grammar interview James Harbeck language linguistics Linguistics Frankly Marianne Grier networking plain language proofreading publishing Rosemary Shipton rédaction révision style traduction translation usage Wasted Words Wilf Popoff word choice writers writing

Email subscriptions

Enter your email address to subscribe to this blog and receive notifications of new posts by email.

Join 1,005 other subscribers

Most recent posts

  • An Interview with Jen Campbell, Editors Canada Conference Keynote Speaker
  • A New Editing Community Emerges: Neurodivergent Editors
  • An Interview with Lorina Stephens, Editors Canada Conference Keynote Speaker
  • Three Ways Long-term Clients Make Freelancing Less Stressful
  • What Does a Recipe Editor Do?

Archives by month

By author

Follow Us Online

Facebook  Twitter  Flickr  RSS Feed

www.editors.ca

The Editors' Weekly is the blog of Editors Canada.

Report an error or a typo

Email us at blog [at] editors.ca

© 2022 The Editors' Weekly

Powered by One Designs