SharePoint for documentation projects

Most of the Technical Authors I have met don’t have a good thing to say about Microsoft SharePoint. In many ways, it represents how not to publish content online. It is seen as encouraging people to move print-optimised documents (Blobs) around, rather than units of content (Chunks), and users are typically left to rely on search… Read more »

Getting information from Subject Matter Experts

Interviews with Subject Matter Experts (SMEs) are some of the most useful sources for Technical Authors when they are gathering information about a product or procedure. This often involves asking a developer or departmental manager a series of questions focused on the types of questions end users are likely to ask. Interviewing is one of… Read more »

New software that might interest Technical Authors

Here are some new tools we’ve found that might interest Technical Authors. Google Ripples Google Ripples is a tool that enables you to watch how posts get shared on Google+. If you publish user assistance or support information via Google+, it could help you track how far and wide it gets distributed. It could also help… Read more »

Writing user documentation collaboratively in an Agile environment

Hi, You provide wonderful newsletters full of useful information. Thank you. I’m a Senior Technical Writer in a small company, and I have one contractor working for me. We have come up against a challenge. <snip>… My team currently uses RoboHelp, which is not a collaborative, team tool for writing. The company likes to think… Read more »

What does a Help Authoring Tool give you over Drupal?

Comparing Help Authoring Tools (HATs) with Drupal is like comparing apples with oranges. HATs are used by Technical Authors to create content in various formats for end users to read. Drupal is open-source software that is used to create websites for users such that they can contribute to the content (for example: blogs, personal or corporate… Read more »