Latest Updates: documentation RSS
-
-
Collaborative Walkthrough Video:
A unique look at how other organizations deal with documentation design and critique. Plus some really good best practice tips.
-
-
Here are some thoughts about how to help developers create adequate tools for educating users. The author asks for feedback on this draft. He shouldn’t just hear from developers and software architects.
Proposed API for tools to help educate computer users online - O’Reilly News.
-
-
-
-
-
-
O’Reilly editor Andy Oram has an excellent article about community-based documentation where he shares his research findings - and it’s not all sugar-coated. Only about half of forum questions are answered correctly, and when a user needs more training or indepth explanations on complex products or configurations, the community can sometimes let them down. Community leaders learn quickly that they can become targets when trying to explain that a task is difficult or complicated. See Educating computer users: the need for community/author collaboration. Find out when documentation deserves further polishing. Excellent insights.
Email delivery