Documentation

When I talk to college students who are working on their first open source projects, the message I emphasize over and over and (yes, one more time) over again is the…

The first task any accomplished technical writer has to do is write for the audience. This task may sound simple, but when I thought about people living all over the world, I…

I discovered AsciiDoc while writing Learn Linux in a Month of Lunches. AsciiDoc is a fantastically thorough markup language for writing books—think Markdown, but with more…

Even if you don't enjoy writing and have no intentions of becoming a professional tech writer, chances are you'll have to draft reports, mailing list updates, or technical…

This article is for the English majors, the bookworms, the lovers of literature, and the people with humanities backgrounds who sometimes struggle with the question, "So do…

One of the common questions when developing documentation is, "How many screenshots should I include?" Answers range from "None!" to "All the screens!" A picture may be worth…