Technical Editing: Resources




General Technical Editing Resources

Geoff Hart on editing. Interesting articles.

Editorium. Resources and tools for MS Word.

Bay Area Editors' Forum. Resources plus jobs for editors.

Grammatika Certification. We're still researching this one. Caveat emptor!

CMOS Online . A forum provided by the Chicago Manual of Style.

TIPS@TechnicalPublishing.com. Offers a copyeditor/proofreader quiz plus wise advice.

EServer TC Library. A huge resource with many categories including editing and style guides.

Technical Editors' Eyrie. Resources for technical editors made available by Jean Weber. More than a dozen articles and many aspects of technical editing, including finding telecommuting work.

Electronic editing: Editing in the computer age. Jean Weber's downloadable book.

Editing Online Help. Jean Weber's downloadable book for students, writers, and editors who are developing online help for computer software.

Textbook resources. Companion website for Carolyn Rude's Technical Editing, 3rd edition.

Van Buren, Robert & Mary Fran Buehler. Levels of Edit Scanned and formatted for PDF by Michael Parcher at Austin Community College.

Internet Resources for Technical Communicators

The Slot: copyeditor site, including the The Curmudgeon's Style Book.

Proofreading Strategies. From the Purdue University Writing Lab.

Favorites

Grammar Girl Quick and Dirty Tips for Better Writing. Click All Episodes.

grammarbook.com. Provided by Jane Straus.

indoition.com. Quite a collection of "basic know-how, checklists, tools and links, which will help you to write create clear and concise user-friendly manuals."

Toaster-Instruction Booklet Author Enraged That Editor Betrayed His Vision

Professional Associations and Certifications

Board of Editors in the Life Sciences. Evaluates the proficiency of manuscript editors in the pfe sciences and to award credentials similar to those obtainable in other professions. According to a participant with ATTW-L, "I think that students who are serious about becoming editors and/or writers in the pfe sciences and related areas should consider pursuing their ELS certification. Many members of COPYEDITING-L have ELS certification. I did some research at a prominent health information company, and they are more interested in 'people with a science background who can write' than 'people with a writing background who can learn the science.' I think the health information industry has ramped up quickly like the TC industry has done; while there will always be people who can 'fall into' one of these types of writing jobs despite having a background in something very different, it is becoming harder for them to do so. The ELS shows prospective employers that a person has been serious about obtaining experience and knowledge related to the field. The ELS certification requires at least 2 years of editing experience, so it might be difficult for student to get at the BA/BS level. However, universities that publish journals in the life sciences might be able to attract students who are interested in becoming editors and help them work toward the ELS certification. Students who take a minor or even a double major in a science field should also be well positioned to seek this kind of work. "

COPYEDITING-L Archives. Rather than subscribe and then post a question that has probably been posted more than once, search the archives. (You have to register to access the archives.)

TECHWR-L. Articles on editing.

Style Guides

13 magically meticulous design style guides. Provided by Craig Stewart of Creative Blog.

McMurrey. Style guides

Adobe. Adobe Corporate Brand Guidelines. Editorial style guidelines do not start until late in this document.

JoAnn T. Hackos. Managing Your Documentation Projects. Wiley. Don't forget; it's on reserve.

EServer Technical Communication Library. Search on style guides in this collection.

TECHWR-L. Similarly, search in TECHWR-L's articles and listserv archives for style guides.

Examples:

Microsoft Vista Text and Tone. Friendlying up user docs.

OpenOffice.org Authors Style Guide. Developed by Janet Swisher for an international community of volunteer authors; requires OpenOffice.org.

AMA bibliographic style. AMA Manual of Style, 10th ed., 2007

American Institute of Physics Style Manual.

European Union Interinstitutional style guide.

IEEE Computer Society Style Guide.

IBM Style Guide. This pnks to a 44-page excerpt of the 416-page version that you pay for: http://www.amazon.com/books/dp/0132101300.

U.S. Government Printing Office Style Manual

Simplified English. From Userlab, Inc. Simplified English was developed to facilitate the use of maintenance manuals by non-native speakers of English. Aerospace manufacturers, for example, are required to write aircraft maintenance documentation in Simplified English.

MIL-STD-498. One of the standard milspecs used for documentation and editing. Also, Wikipedia has an article: MIL-STD-498. Thanks to Christine Hall for these links.

Developing a Departmental Style Guide. Made available by Jean Hollis Weber.

US Government Printing Office Style Guide.

Scriptorium Style Guide.

American Institute of Physics Style Manual.

European Union Interinstitutional style guide.

IEEE Computer Society Style Guide.

Apple Publications Style Guide.

Microsoft Manual of Style for Technical Publications. Used to be available free as a 1077KB help file (.chm) and as a .pdf.

Wikipedia: Manual of Style.

Read Me First! A Style Guide for the Computer Industry. Unfortunately, this fine book by Sun Technical Publications you must purchase. Sun Technical Publications: Mountain View, CA.

Handbook for Technical Writers and Editors: Grammar, Punctuation, and Capitalization. NASA publication, produced by Mary K. McCaskill at the Langley Research Center.

Style Guide for Online Hypertext. From the founders of the web . . .

The Yale Web Style Guide. Fine material from the Yale Center for Advanced Instructional Media.

Editing Online

Editing with abbreviations and macros

Editing with revision markers

Reviewing PDF Docments

Online commenting

Track changes. Produced by Shauna Kelly, Microsoft MVP for Word, Melbourne, Australia. (Includes tutorials on styles.)

Grammar, Usage, Punctuation

Its a catastrophe for the apostrophe in Britain. Say it ain't so!

Bedford-St. Martin companion website. Lots of diagnostics and exercises for grammar, usage, punctuation.

Merriam-Webster Online

Common Errors in English. Provided by Paul Brians, Washington State University.

Sentence diagnostic

Guide to Grammar and Writing. Provided by Charles Darling at Capital Community College.

Guide to Grammar and Style. Made available by Jack Lynch. Includes plenty of links to other resources.

Grammar & Usage Study Guides. From David McMurrey. Scroll to guidelines.

Plain English

Plain Language for Lawyers. From Plain Language for Lawyers, Michèle M. Asprey

Clear English Could Be a Big Winner in the Facebook Affair.

Plain English Handbook. From the U.S. Securities and Exchange Commission.

Plain English Campaign in England. From the founders of the movement.
Healthier Together: Strategic Direction Case. Described as "hideous and gobbledygook-ridden," "tripe dissolved in twaddle," and "the most incomprehensible, opaque and jargon-ridden document I have read in the last 30 years" by Graham Stringer, MP for Blackley and Broughton.

Plain Language Action Network (PLAN) . A government-wide group working to improve federal government communications established by the National Partnership for Reinventing Government (NPR) and the Office of Management and Budget (OMB) established PLAN and guided by Plain English Network (PEN). (But now we need a movement to wipe out acronyms!)

Plain Language Online Training. From Human Resources Development Canada.

NIH Plain Language Online Training

Professional Societies, Listservs and Forums

American Copy Editors Society. ACES.

PainintheEnglish.com. A forum for the "gray areas" of the English language.

COPYEDITING-L Archives. Rather than subscribe and then post a question that has probably been posted more than once, search the archives. (You have to register to access the archives.)

Copyediting Forum. From copyediting.com.

TECHWR-L Mailing List Archive. Click Email Discussion Group Archives.

Reference Materials

One Look Dictionaries

National Institutes of Standards and Technology

alt.usage.english FAQ

WWWebster Dictionary. Merriam-Webster's Collegiate Dictionary, Tenth Edition

Common Proofreading Symbols

Editing Services

Compass Rose Technologies, Inc.. One service's fees for various types of editing.

Karen L. lew. Another service's fees for various types of editing.

Exceptional English. Still another.

Thompson Writing & Editing, Inc.. And another.

Editing Employment

Executive Search Associates. Someone claimed this had editing work, but I did not find it (but didn't try too hard).

Try jobsites like these and search on editor, editing, etc.:

monster.com

indeed.com

dice.com

Programs and information provided by hcexres@prismnet.com.