Best Practice

Best practice within technical communications

Information Architecture

Information architecture (IA) focuses on organising, structuring and labelling content to help users find information and complete tasks. This article this article provides an introduction to information architecture and its importance for technical communicators.

Privacy practices as a Technical Communicator

An article about the best privacy practice to take as a Technical Communicator when creating documents, based off the New Zealand Privacy Act 2020.

The Social Life of Git

Working with Subject Matter Experts

What can you do when the required Subject Matter Experts (SME) are reluctant to collaborate?

Working from home

When you spend hours at your desk every day, even the smallest features of your workspace will affect your comfort and productivity.

Collaborative editing: editors as the author’s helpmate

Editing is an inherently collaborative activity. Geoff discusses his experience working collaboratively as a freelance editor.

Documentation in an Agile Environment

Agile methodology is well established for software development; it is now more common than the Waterfall method. The Agile methodology presents good opportunities for the documentation to be embedded in the development process.

What's the evidence? Does user onboarding work?

You get a new app and all these tips pop up. Do people engage with this stuff? Is it useful? As far as I can tell, the jury’s still out on this. There’s research and plenty of advice, but no convincing evidence.

Managing Reviews

Encouraging reviewers to respond to review requests can seem a daunting and thankless task. There are a variety of strategies you can use to help ensure you receive the review you need.