“Push me, Pull me” dilemma for technical authors

There are a number of posts on various Blogs, at the moment, concerning documents as conversation and moving beyond the traditional manual. Some of the comments suggest implicitly  that technical authors (aka technical writers) could end up having to resolve two conflicting views regarding communicating with users.  The problem is that many technical communicators work in hierarchical organisations where… Read more »

Is the future of education also the future of technical communication?

I stumbled across another great video of Michael Wesch talking about the issues facing educationalists.  Many of the problems they face are the same as those faced by people involved in producing user assistance. The video is here Dubbed “the explainer” by popular geek publication Wired because of his viral YouTube video that summarizes Web… Read more »

The “Google or Death?” choice for technical authors

July’s edition of Science magazine includes a study that shows scientific researchers are now more inclined to get their information from the Web (specifically, “quick and dirty” searches in Google) than from specialist scientific resources. If scientists are focusing on only a tiny bit of research – the bits served up by Google – what are typical users… Read more »

What should you include in your user documentation?

Technical authors are faced with limited time and resources, so they often are faced with the dilemma as to what to include and what to leave out of their user documentation. You may ask, if 80% read only 20% of the content, is there any value in documenting the rest? Technical Authors are often great… Read more »

“The worst Help system I have ever seen”

Sarah Maddox reported from the WritersUA conference that Microsoft’s April Reagan gave a frank presentation on the planning and design that has gone into version 3 of Microsoft Help. She was quoted as saying the feedback on the Help 2 (used in Windows Vista) was poor. For example, “This is the worst help system I have ever seen”.  At a previous… Read more »