How to Start Writing REST or Web API Documentation

API documentation template

Let’s say you’ve been asked to document a set of REST or Web APIs, a new area for you. Where do you start? At first this can seem overwhelming. So many new acronyms, terms, jargon, and pieces to fit together. Here’s a suggested approach. Focus on a specific api,  for example, REST. Ignore the temptation […]

Quality Assurance Plan Template in MS Word/Excel

Looking for a Quality Assurance Plan template? We’ve spent most of the week polishing this fella and now he’s ready for prime time. See what you think. Quality Assurance Plan Template This template pack includes a 39-page Quality Assurance Plan Template in MS Word, an Audit checklist and Schedule Forms, and 7 Excel spreadsheets. You […]

How To Increase the Number of Words You Can Type Per Minute

typing skills for business writers

My friend PM wants to go into freelance writing. I think it can work for him. He’s determined, has a nice writing style, and knows how to hustle for work. But typing is a problem. It’s that simple. He pecks and pecks at the keyboard. Last weekend, his house he showed me some gizmos, ‘hacks’, […]

Jane Austen – My Favorite Quotes

Maybe you think Jane Austen is hard to read. She’s not. Here’s an example of her writing. Most are from Persuasion. “Let us never underestimate the power of a well-written letter.” “I hate to hear you talk about all women as if they were fine ladies instead of rational creatures. None of us want to be […]

Should CEOs learn Latin?

Should you learn a dead language? Isn’t there more important things to do? The short answer is Yes. Well, maybe. Actually, No. You really should start learning Latin and here’s why. The Spectator summarising one influential American study carried out in the state of Iowa: “In 1971, more than 4,000 fourth-, fifth- and sixth-grade pupils of […]

How to Start a Career as a White Paper Writer

Want to get started as a white paper writer? It mightn’t be as hard as you think. If you have good (not necessarily perfect) writing skills, in-depth knowledge of a product, service, or industry, and have the right attitude, then maybe you should consider writing white papers to earn extra income. Due to the recession […]

How to improve the subject line of an email

First, think of the response you want from the reader. Second, put the most important point at the start. Third, highlight one thing only. The problem with most subject lines in emails is that they’re written either: As a placeholder, something to put in while you write the actual email After the email is written […]

Are good business writers made or born?

If you’re reading this, you’re probably thinking… made. Why do I say this? Because if you are a ‘born writer’, and have written from a very early age as most do, you’d feel  that most writers are born, not made. You either have it or you don’t. But it this true? I hate to say it […]

Friday Book Review: Patricia Highsmith’s Deep Water

In WSJ, Gillian Flynn, the author of Gone Girl, says about Deep Water, “When you decide to pair yourself off with someone for life, it’s supposed to be this psychologically and emotionally safe place you can retreat to. And often it doesn’t turn out like that, and there’s something very frightening about revealing not just […]