Readme.io Ouch

In November, I began an adventure with a new tool, readme.io. At least, new for me. I like to think all tools add something to your portfolio of skills. I enjoy learning new tools. Mostly, I like to find the unique benefit. So when I was hired by a small startup with only 14 people, I was eager to discuss what they wanted me to deliver and what tool I would use. The company was in stealth mode.…

Comments Off on Readme.io Ouch

Social Media 101: Are you shouting in an empty room?

The core of all social media activity is not what you say, but to whom you are saying it. If you have the most persuasive argument, the most sellable product, and even the largest sales budget known to mankind, it means nothing if you haven't built the network of people ready to listen to the argument, learn about the product, see those fancy ads you spent a fortune on designing. Social media is dynamic. It's exciting. It's reaching…

Comments Off on Social Media 101: Are you shouting in an empty room?

Ten Tips for Using Flare

In no particular order, some tips for using Madcap Flare. When creating your documentation – think Conditions! Is your document intended for more than one type of user? Are you supporting more than one version, multiple but similar products, text that is reused? If yes, the answer may well be Conditional Text. Use multiple tables of contents – using more than one TOC enables you to organize help or printed documentation in a different order, each best suited…

Comments Off on Ten Tips for Using Flare

What Name Shall I Name?

It's really easy for users to know what something is called in the product they are using. They just have to read the documentation...right? The problem is...how did that name get in the documentation? Is it the right name? As technical writers, we know that sometimes we can ask the marketing department; sometimes we can ask the developers. But when you live in a place where the language of the product is considered the second (or third or fourth…

Comments Off on What Name Shall I Name?