Two Ways to Chunk Content with MadCap Flare

Mike Hamilton on the MadCap blog wrote an excellent tutorial on how to chunk content. We’ve covered this subject before, especially when looking at information architecture and how to write for the web. What’s interesting about Mike’s article is how he uses conditional markers to do this in MadCap Flare.

Bling Your Technical Documents

Do technical writers like bling? You betcha. You can now give your MadCap Flare web output a new look by updating its skin. This makes the online documents look that bit flashier. You can also look at modifying the skins to give your technical docs an interested edge. Download MadCap Flare Skin Gallery To add […]

Eddie Van Arsdall’s Ten Tips for FrameMaker Docs

If you use Adobe FrameMaker and wondered ‘well how could I get these documents into another tech writing tool’, then read this week’s edition of MadNewz from Madcap Software. Eddie VanArsdall has written a great tutorial that shows how to move content between these packages.

Svi Ben-Elya on Technical Writing in Israel

After moving to Israel in the early 1980s, Mr. Ben-Elya became one of Israel’s first technical writers. He developed a reputation for helping companies solve their documentation problems innovatively but painlessly, while within the technical writing community he became known for helping others. Mr. Ben-Elya’s reputation enabled him bring together all parts of Israel’s technical writing community (independent contractors, technical writing companies, and in-house writers) in Oct. 2003 to found Elephant. http://elephant.org.il.

Are Daily Rates for Technical Writers Starting To Improve?

In December, I looked at the daily rates for technical writers and others in the tech comms industry. At the time daily rates for technical writers are down to $30 per hour in some places in the Bay Area. However, maybe things are starting to turn around. In Ireland (Euro HQ for most US IT companies) Google has announced 150 new jobs, many in technical roles. So, is the tide starting to turn?

Does your writing have an accent?

Maybe you don’t hear your accent, but others do. When you read their documents, does the accent come through?

Do CEOs Need to Write Well to Succeed?

Thom Haller asks on TCW if ‘to be an effective leader, you need to learn how to write well’.

10 Best Mistakes I Made in 2009

Fail to prepare, prepare to fail. If you don’t know your mistakes you’re going to repeat them. Here’s my best mistakes.

How do you measure the value of technical documents?

One of our tech docs team was fired yesterday. Why? Technical documents provide no value. This is how Management sees it. Tech docs are nice to have but NOT essential. Tech docs are useful but LESS important than development, user interface and marketing. Are they right? It’s hard not to get defensive in these situations. […]

Are technical documents a waste of time?

“Don’t worry” she said. “No one reads this stuff anyway. Just get it done.” Sounds familiar? These were the words a former Project Manager once told me. I’d written 20,000 words for a banking system – and no-one would read it. What do you do when your own company has such a poor view of […]