Category Archives: Style Guide

10 (Very Short) Web Writing Tips

If you want to improve your web writing skills, follow these 10 steps: Write in chucks. To create your hierarchy, outline the website as you would for printed material. Examine the site’s purpose and outline the main sections (e.g. words people use to navigate) and the links within those heads. Test it before it goes […]

MS Word: How to Turn off Field Codes in Table of Contents

James asks, “In Word, the Table of Contents gives an error message: { TOCO “2-4″H Z T “HEADING 1,1″}. How do I fix this?” I think the problem is to do with Field Codes. If you want to turn off field codes from appearing your Table of Contents in MS Word, follow these steps: In Word, […]

How to Hire a Technical Writer

If you want to know how to hire a technical writer, read these guidelines. Jane R. in Texas asks for some tips on interviewing tech writers, especially when using assessment tests. Her company is about to hire their first full-time writer and they have not done this before. I’ve worked on both sides on the fence […]

What is a Technical Writer?

Technical writers write technical documents that explain complex issues in simple, plain English. Technical writers – also know as Technical Authors or Information Designers – write material that supports software and hardware systems. They design, write and produce material that is delivered in print, soft-copy or as Online Help, such as that found in the […]

How to manage large documents in Microsoft Word

The main issues with creating long docs in Word tend to involve formatting, styles, graphics, tables, and bullets. Formatting — cutting/pasting material directly from one file into another is best avoided as this will bring unwanted styles in the target Word file. Instead convert it to raw text and then import it. Styles — create […]