TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
I just had someone complain "why is the stuff you write always so long?". He's the only person who has said this. I don't think it's what I write (I'm not that verbose), and I don't go overboard with screen captures.
I think it has more to do with the design of the document itself. This is a PDF document that explains how to set up cross-references in a third-party application, so that our application can query it for data. It also briefly describes how to use those query results. The document is meant for office workers not developers or IT personnel. The process isn't complex. There's just a lot of jumping around between our application and the other application and different screens in each.
Does anyone have suggestions on how to make a document more compact, so I can get the same amount of information in a smaller "package"? Or can you give me examples of ones that you think are well done?
Thanks in advance!
Debbi
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l
