Category: Style

Posted on

From Around the Web: The Cybersecurity Style Guide

Editors use style guides to ensure the consistency and clarity of the documentation they review – they are one of the most important tools in a editor’s toolbox. But just like different companies have different style guides, so too do different industries.

Brianne Hughes, a technical editor for Bishop Fox, is one of the authors of The Cybersecurity Style Guide. For an interview with Brianne, in which she explains the need for this type of specialized style guide, see the following link:

http://cmosshoptalk.com/2018/05/15/brianne-hughes-talks-about-the-cybersecurity-style-guide/

Brianne says that this is a document in progress, and that she and her team plan to put out a cleaner V1.1 soon. They are always happy to receive suggestions for future improvement, so if you have any, please contact her via her at style@bishopfox.com.

UPDATE (23 July 2018):

Version 1.1 of the Cybersecurity Style Guide has been published: https://www.bishopfox.com/blog/2018/06/reintroducing-the-cybersecurity-style-guide-v1-1/

Posted on

Quo Corrigo? Survey Results

At the end of April 2018, we sent out a survey called “Quo Corrigo?” asking Corrigo readers to tell us about what kind of content they wanted to see here.

We felt that Corrigo should only present information that focuses on technical editing, rather than on generic technical communication. But we weren’t sure what that meant exactly, so we turned to you to help us define the future scope and direction of Corrigo.

As of the end of June 2018, we’ve received 35 responses to our survey, and we thank all of you who took the time to tell us your opinions.

Continue reading “Quo Corrigo? Survey Results”

Posted on

Copyeditors Can Make Web Copy Sing

by Erin Brenner

2015 Headshot brown cropped 600x548Professional copyeditors tend to think of the Web as devoid of good writing. Website owners will throw any old copy up on the site, careless of good grammar, never mind rhythm and style. While quality sites are out there (think the New York Times and The Atlantic), they still make mistakes and many more websites are in need of a skillful copyeditor to help raise standards. Continue reading “Copyeditors Can Make Web Copy Sing”

Posted on

Let Go of the Words?

Michelle Corbin

As technical editors, we love words. We love making sure that each word communicates clearly. If you hear that someone is an editor, you immediately think of grammar and syntax and word usage. But, as technical editors, the time has come (really, it came a while ago, but the saying goes, “the time has come”) for us to let go of a singular focus on the words. As technical editors, we must edit so much more than just the words—words on the paper or words on the screen, words in a PDF or words in a help file, words in a user interface or in a message. We have to look beyond the words.

Continue reading “Let Go of the Words?”