Posts tagged: list

The 4 most important writing resources

dreamstimefree_26374161This is a general list of useful resources for technical writers, which may also be helpful to other writers and communicators. I’m not necessarily advocating any particular products, but the examples will be the products I use myself.

1. Dictionary

I don’t think I can stress enough the importance of a good dictionary. A writer must produce correct spelling, grammar and usage and all of these are provided in a good dictionary.

I will also stress the importance of always using the same dictionary. By using the same dictionary for all your writing, your writing will be much more consistent. And if you’re writing for a client, you can always defend your writing decisions by referring to your chosen dictionary.

Being in Canada, I use the Canadian Oxford Dictionary, but the Oxford Dictionary of English is also available as an excellent authority of the English language.

2. Style guide

A style guide is another resource of which I cannot stress the importance enough. Whether you’re using Strunk & White’s The Elements of StyleThe Associated Press Stylebook 2009 or the Canadian Press Stylebook, you can ensure consistentcy in your writing. This works in your favour again by making it easier to defend your writing decisions.

Specifically for technical applications, I use the Microsoft Manual of Style for Technical Publications (sorry, this links to the second edition, and I would definitely recommend the third edition). This is an excellent guide for writing documentation and communication for software applications.

I also recommend to create a personal style guide.  While writing, make notes about preferred words, terms and other usage. Are you going to use am and pm, a.m. and p.m. or a 24-hour system (08:00, 20:00)? How are you going to write time zones? How do you handle abbreviations? While making your writing more consistent, it also removes the need to make these kinds of decisions on the fly.

3. Usage guide

While a usage guide can often be replaced by a dictionary and style guide, it helps to make decisions about usage in new situations, or confirm usage in awkward situations.

While I’ve heard some comments against it, I prefer Fowler’s Modern English Usage. I’ve managed to resolve a number of usage conflicts using Fowler’s; for example, whether I can use nor without having previously used neither (yes, I can).

4. Thesaurus

I do not to use a thesaurus. To quote Stephen King:

Any word you have to hunt for in a thesaurus is the wrong word. There are no exceptions to this rule.
— Stephen King, “Everything You Need to Know About Writing Successfully – in Ten Minutes”, 1988

Conclusion

To conclude, you see that there aren’t many resources, and there shouldn’t be. The more you have to make reference to a book, guide or even your own notes, you slow down your writing. And, if you’re like me, you lose your train of thought and your writing suffers. You don’t have to use (or even like) the suggestions I’ve made, but sticking to specific resources will ensure your writing is consistent and any decisions can be defended.

What are your preferred resources?

WordPress Themes