Knowledgedoc Technical Writing Blog - May 2015

Coordinating caption and page numbers with headings

Rachel Woolley
by Rachel Woolley

If you’ve set up numbered headings in your Microsoft Word document you might be wondering how to coordinate all the other numbers in your document with your headings. This article will discuss ways to add chapter numbers to page numbers and caption numbers, in the format of 1-1, 1-2 for chapter 1 and 2-1, 2-2 for chapter 2. Typically you use the Heading 1 style to signify a new chapter.

It’s extremely simple to set up page numbers that match your chapter numbering in Microsoft Word, and it’s well worth it when you’re organising a large document into numbered chapters.

Read more

Creating single sourcing topics

Neil Woolley
by Neil Woolley

In my last article, An introduction to single sourcing, I discussed how we have progressed from ‘write once, copy by longhand many times’ to mostly ‘write once, copy many times electronically’.

For over 12 years, we have been using our skills, experience and tools to ‘write once, reuse many times’. Many of our customers enjoy lower ‘total cost of ownership’ by single sourcing content.

Read more

Managing your creative bank

Richard Kennedy
by Richard Kennedy

The technical writer is the communication industry’s version of a Swiss-army knife. For any given project a technical writer is required to draw upon skills covering writing, graphic design, programming, and project management.

And, since business customers always want to present the most modern documentation, these skills need to be constantly updated. Ideally, as a technical writer you should be ahead of the curve. Achieving this goal means effectively managing and updating your “creative bank” of skills.

Read more

Documentation, printed or online?

Sue Woolley
by Sue Woolley

One of my first jobs in the IT industry was working at the Australian National University Computer Centre as the “Consultant Programmer”. Wonderful title, these days I would probably be called the Help Desk Manager.

My job was to assist staff and research students when they had problems using the Univac 1100/80 mainframe computer. To help me, I had several shelves of very, very technical printed Univac manuals which I had to delve into on a regular basis. The users had no access to these manuals, and even if they did, they would probably have been too technical to help them in any way.

Read more