Technical documents provide information that readers need to make decisions or complete tasks. Technical editing ensures that this information is presented in a way that facilitates the reader's understanding. Technical editors offer suggestions for improvement in design of both content and layout and therefore work with the document in both early and late stages.
The ABCs of Writing a Technical Glossary

This article identifies and explains format rules, style rules, and lexicographic conventions that have been shown to improve clarity and precision in a technical glossary. Rationale for the rules of language, presentation, and style are examined. The need to allow flexibility in following the rules is discussed in terms of strengthening the technical merit and vitality of the glossary. This article also describes the computer-display techniques and file-management system used in committee to develop U.S. Federal Standard 1037C, Glossary of telecommunication terms, and to display the results both in the meeting room and on the Internet between meetings.
Gray, Evie, William Ingram and Dennis Bodson. Technical Communication Online (1998). Articles>Editing>Technical Editing>Glossary
If you ever create shadows in your designs or illustrations, check out these tips for making them richer and more realistic.
Campbell, J. Scott. Adobe Magazine (1997). Design>Graphic Design>Image Editing
Access to Current and Next-Generation Information Systems by People with Disabilities
The purpose of this document is to provide information and resources for those interested in learning more about accessibility issues and current and next-generation information systems. The current focus of this document is on the National Information Infrastructure (NII), sometimes known as the 'information superhighway.' This document contains both information presented at a very introductory level and information which is more technical in nature. Wherever possible, all of the technical discussions are broken out and presented separately, so that readers may course through the material at a level which is comfortable to them, and which meets their information needs. This is a living document which will be continually revised and added to as more information is collected and as the efforts in the area of research, development, and public policy continue to evolve. The most recent form of this document can be found on the Internet via our ftp, gopher, or WWW servers. All of these are located at: trace.wisc.edu The document can be viewed on-line or downloaded in one of several forms to facilitate accessibility.
University of Wisconsin. Articles>Editing>Accessibility>Usability
A collection of reviews of recent books in editing (particularly for journalism).
This is the American Copy Editors Society site for job postings of interest to copy editors or others in journalism and other editing careers.
Adapting Traditional Editing Practices for Online Documentation
Developing a process and using guidelines for editing online documents, both rooted in traditional editing practices.
Fink, Bonnie L., Carol E. Gasser, Jennifer L. Giordano and Beth A. Williams. STC Orange County (1998). Presentations>Documentation>Editing
Adapting Traditional Editing Practices for Online Documentation 
Technical editors are possibly best known for their abilities to transform information with format, content, grammatical, and mechanical problems into coherent, concise, understandable, and usable documents. Editors must not only provide such services for the information authors, but they must also understand and support users' needs and expectations. This presentation gives editors an approach to editing online documentation that is rooted in traditional editing practices.
Fink, Bonnie L., Carol Gasser, Jennifer Giordano and Beth A. Williams. STC Proceedings (1998). Articles>Editing>Documentation>Online
Adding Reflections to Water in Photoshop
Denny Tang shows how to add sparkle to your images of water in this Photoshop tutorial.
Tang, Denny. Graphics.com (2005). Design>Graphic Design>Image Editing>Adobe Photoshop
Allegro Time! provides practical ideas for professional technical communicators. It will help you to assist your customers find answers in the documentation you've put so much effort into writing. Indexing topics covered include print manuals, online help keywords, single-source publishing, multimedia and the Internet.
It is important to alphabetize your index in a consistent manner. Otherwise, your readers may become confused or miss an important entry. There are two basic ways to alphabetize, or sort, an index: word by word; letter by letter.
Brown, Fred. Allegro Time! (2001). Articles>Indexing>Editing
'It's all in the manual.' How many times have you heard that - or said it in frustration? After all, when you are the person who wrote the manual, you know that all the answers are there. But time and again readers can't find what they need to know, or don't understand the material. Before you blame the reader, look again at how you've presented the material.
Hollis Weber, Jean. Technical Editors Eyrie (1989). Articles>Editing>Technical Writing
The American Copy Editors Society, a professional organization of copy editors, is dedicated to improving the quality of journalism and the working lives of journalists. Our main purpose is to educate our members--and others in the news business--in ways of improving the standards of copy editing and increasing the value the news industry places on our craft. While our primary focus is on newspaper copy editing, we welcome editors from other publications, as well as academic representatives and students.
ASI is the only professional organization in the United States devoted solely to the advancement of indexing, abstracting, and database building.
Angels and Copy Editors Defend Us!
Tinkering with the author's words simply because 'I would not write them that way' is not discretion, but interference. Preserving the author's authentic voice is as important as enhancing its presentation so as to maintain the authority of the words. Of what, then, does the enhancing consist? And how does editorial discretion fit in?
Fothergill-Brown, Ann. Writer's Block (1999). Articles>Writing>Editing
Talented people with the editorial skills of condensing and organizing copy can often position themselves for jobs that don’t bear the title 'Editor.'
Bush, Donald W. Intercom (2001). Careers>Editing
Ask the Indexer: Get Answers to your Indexing Questions from Experienced Technical Indexers 
After brief introductions by 4 panelists who are all members of the Indexing SIG (and experienced indexers and technical writers), we plan to discuss Frequently Asked Questions (FAQs) about indexing, and allow plenty of time for questions.
Bonura, Larry S., Dick Evans, Joan K. Griffitts and Peg Mauer. STC Proceedings (1999). Articles>Indexing>Technical Editing>FAQ
Australian and New Zealand Society of Indexers 
The Australian and New Zealand Society of Indexers (ANZI) aims to represent the interests of indexers and to provide training and other resources to all Australians and New Zealanders involved in indexing, whether they are freelancers or employees, full-time, part-time or casual.
Suggests several uses of Microsoft Word's macro capabilities to help editors improve their speed and consistency. Macros, for example, are customized keystroke commands.
Hart, Geoffrey J.S. Intercom (2001). Articles>Editing>Software>Microsoft Word
Barriers and Approaches to Reviewing Documentation
This article discusses some important issues in implementing a software documentation review process. If you are part of a small development organization and have few reviewer resources available, you may have to improvise techniques for providing the services and procedures suggested here.
Boston Broadside (1997). Articles>Documentation>Editing>Collaboration
Becoming a Journal Peer Reviewer 
This session will help participants understand the process for reviewing manuscripts submitted to Technical Communication. It covers the types of articles the journal publishes, review procedures and criteria, and approaches to writing constructive evaluations.
Hayhoe, George F. STC Proceedings (1998). Presentations>Editing>Technical Editing
Becoming a Journal Peer Reviewer 
This session will help participants understand the process for reviewing manuscripts submitted to
Hayhoe, George F. STC Proceedings (1999). Articles>Publishing>Editing
A physicist-turned-editor shows you the basics required for copyediting physics papers (physical quantities, symbols, units, scientific notation, the structure of mathematical expressions, the nature of graphs), and points the way to learning enough 'editorial physics' to begin substantive editing.
Murphy, Peter W. STC Proceedings (1995). Articles>Editing>Scientific Communication
Beyond Copy-Editing: The Editor-Writer Relationship
Editing is often narrowly defined as making corrections after a document is written. This approach typically relegates the editor to a low-status role within the organisation.
Durham, Marsha. Technical Editors Eyrie (1991). Articles>Editing>Collaboration
Editing must change for the Web, but perhaps not so much as you think. In paper publishing, different documents require different rules and procedures: An annual report requires more editing and more attention to detail than an office memo. Similarly, not all Web documents are equal.
Ivey, Keith C. Editorial Eye, The (1996). Articles>Web Design>Editing>Writing
There are 15 readers currently online: 0 registered users and 15 guests. Register.

![]()
![]()


![]()
![]()
![]()