2 Golden Principles of Technical Document Peer Review

There will be instances in your career as a professional writer when you will be asked to “peer review” (which is, yes, a compound “verb” these days) someone else’s work. This may happen in group meeting (or teleconference/webinar) situations when you may be invited to offer you views on how to improve a certain copy…

Read More

The Discipline of Punctuation in Technical Writing

© Ugur Akinci Today let’s talk about the discipline of punctuation Technical writing is nothing if it’s not about discipline, precision and consistency. That’s how tech writers impose order on disorder. One of the most basic we impose that order on an otherwise unruly collection of information is the application of stringent punctuation rules. When…

Read More

2 File-Naming Tips for Higher Productivity

Every technical writer at some point in his or her career faces this problem until a solution is found: too many files thrown together in a folder, without any easy way to tell which is what. Here are some of my own file naming tips that have helped me a lot over the years. File…

Read More
Technical Article Writing

7 Tips to Write Effective Technical Magazine Articles

 Introduction Writing effective technical magazine articles could be great to heighten your visibility as a technical writer. There are many respectable industry magazines and journals like STC’s INTERCOM where you can try to publish your articles both to share your valuable knowledge with the vast technical writing community out there and to market your services…

Read More

Must Concepts for Software Document Writers

© Ugur Akinci It helps to know what the following are if you’re documenting any software products. It cuts down on your preparation time and saves you from getting those “funny stares” from the developers/engineers when it becomes apparent that you don’t know what you’re talking about. Rule of thumb: always do your homework first…

Read More

The Difference a Comma Makes

© Ugur Akinci Technical writers must watch their punctuation like a hawk because of the dramatic difference a misplaced punctuation mark makes. Here is a great example from the Understanding Uncertainty web site: “how unlikely the result is due to chance” versus “how unlikely the result is, due to chance” Click here to read the…

Read More