{"title":"Anti-Patterns in End-User Documentation","authors":"R. Laue","doi":"10.1145/3147704.3147726","DOIUrl":null,"url":null,"abstract":"The purpose of technical documentation for end-users (in printed or on-screen form) is to enable people to achieve their goals by working with a product effectively, efficiently and in a safe manner. Technical documentation that has to be read by end users provides a special demand because the way of thinking and the vocabulary of a typical end user is different from that of a technical expert. Six documentation anti-patterns are discussed in this paper. They address the structure of the documentation, the organization of the access to its contents and the language used in the documentation. In addition to the discussion of anti-patterns, the article contains suggestions for better solutions.","PeriodicalId":171324,"journal":{"name":"Proceedings of the 22nd European Conference on Pattern Languages of Programs","volume":"91 6","pages":"0"},"PeriodicalIF":0.0000,"publicationDate":"2017-07-12","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":"3","resultStr":null,"platform":"Semanticscholar","paperid":null,"PeriodicalName":"Proceedings of the 22nd European Conference on Pattern Languages of Programs","FirstCategoryId":"1085","ListUrlMain":"https://doi.org/10.1145/3147704.3147726","RegionNum":0,"RegionCategory":null,"ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":null,"EPubDate":"","PubModel":"","JCR":"","JCRName":"","Score":null,"Total":0}
引用次数: 3
Abstract
The purpose of technical documentation for end-users (in printed or on-screen form) is to enable people to achieve their goals by working with a product effectively, efficiently and in a safe manner. Technical documentation that has to be read by end users provides a special demand because the way of thinking and the vocabulary of a typical end user is different from that of a technical expert. Six documentation anti-patterns are discussed in this paper. They address the structure of the documentation, the organization of the access to its contents and the language used in the documentation. In addition to the discussion of anti-patterns, the article contains suggestions for better solutions.