Developing User Assistance for Mobile Apps, 2nd Edition, by Joe Welinske
Joe Welinske just published his second edition of Developing Mobile User Assistance.
Although it’s the second edition, 300 of the 400 pages are new, making it mostly a new book. If you’re doing anything related to mobile, this is a must-read book. It (Read more...)
If you write developer documentation, you know that developers prefer code samples to narrative instruction. The beauty of code samples is that they provide context at a glance. You can see where variables should be declared, functions called, objects initialized, and so forth — all by just looking at the code. Trying to describe the (Read more...)
The September issue of the STC Intercom is entirely dedicated to API documentation. I had the opportunity to act as guest editor for this issue. As guest editor, I helped select the topics, find the writers, and did some editing on the articles. I also wrote a foreword to the articles. It was a pretty (Read more...)
King: It’s what you hear in your head, but it’s never right the first time. So you have to rewrite it and revise it. My rule of thumb is that a short story of 3,000 words should be rewritten down to 2,500. It’s not always true, but mostly it is. You need to take out the stuff that’s just sitting there and doing nothing. No slackers allowed! All meat, no filler!
read it all.
In this series, I’m exploring ways to author in DITA and publish with WordPress. In previous posts, some commenters wondered whether it would be possible to simply author everything in WordPress, rather than continually importing from DITA. In this post, I’ll explore that model.
One of the strengths of authoring content directly in WordPress (Read more...)