Anti-Patterns in End-User Documentation

R. Laue
{"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.
最终用户文档中的反模式
为最终用户提供技术文档(以印刷或屏幕形式)的目的是使人们能够通过有效、高效和安全的方式使用产品来实现他们的目标。终端用户必须阅读的技术文档提供了一种特殊的需求,因为典型终端用户的思维方式和词汇表不同于技术专家。本文讨论了六种文档反模式。它们涉及文档的结构、访问文档内容的组织以及文档中使用的语言。除了对反模式的讨论之外,本文还包含了对更好的解决方案的建议。
本文章由计算机程序翻译,如有差异,请以英文原文为准。
求助全文
约1分钟内获得全文 求助全文
来源期刊
自引率
0.00%
发文量
0
×
引用
GB/T 7714-2015
复制
MLA
复制
APA
复制
导出至
BibTeX EndNote RefMan NoteFirst NoteExpress
×
提示
您的信息不完整,为了账户安全,请先补充。
现在去补充
×
提示
您因"违规操作"
具体请查看互助需知
我知道了
×
提示
确定
请完成安全验证×
copy
已复制链接
快去分享给好友吧!
我知道了
右上角分享
点击右上角分享
0
联系我们:info@booksci.cn Book学术提供免费学术资源搜索服务,方便国内外学者检索中英文文献。致力于提供最便捷和优质的服务体验。 Copyright © 2023 布克学术 All rights reserved.
京ICP备2023020795号-1
ghs 京公网安备 11010802042870号
Book学术文献互助
Book学术文献互助群
群 号:481959085
Book学术官方微信