How To Write Usable User Documentation
?There may be guidance that pre-dates Weiss' book, but for me this represents the beginnings of user-friendly documentation. Anyone who has struggled through a manufacturer's manuals....needs to know that there is a better way to serve the customer....Effective documentation must factor in motivation....Wiess shows us how....The other problem with conventional documentation, is its internal organization. Instead of self-contained answers, one is forced to leaf from one partial explanation to the next....Weiss gets directly to the point. His answer is modularization. Each section must be short, focused, self-contained, and conceptually autonomous. It must be able to stand on its own, so that if the reader stops right there (wherever that is), he can resume reading without loss at a later point. YES!?-HTML Author