Guest Post

Question: Tell me about yourself Evaluates:-Vocabulary and use of language-Clarity and structure in thoughts-Articulation of their own talents-Ability to understand the context-Understanding the audience-Research skills about audience/subject-Judgment of how much information to provide-Creativity, creating interest, story/examples. Question: Describe technical writing Evaluates:-Familiarity with the profession and the working environment-Familiarity with top skills in writing, grammar, user …

My top three interview questions to technical writers, and why Read More »

I enjoyed this interview ‘Life as a Technical Writer in Australia’ because I could relate to so much of what was being said. Although Swapnil lives in Melbourne, news of him travels across the ditch to us in Auckland, mostly because of his tremendous contribution to Write the Docs Australia. When I spoke to him, …

One tech-writing advocate interviews another Read More »

My 4 tips for writing API documentation for new writers. 1. You must understand the solution you are documenting. Play with the API until you are sure you know how it works. 2. In your documentation, explain each input parameter clearly. For example, do not just say the values for a parameter can be true …

API-documentation tips for new writers Read More »

When I talk to companies about the importance of Technical Communication and having a properly trained Technical Communicator on staff, I often hear people say: OK, interesting, but how much does it cost me? My answer in this case is: But have you thought about how much it costs you not to have one? A …

How much does it cost to have a technical communicator in the company? Read More »