应用API可用性的认知维度来改进API文档规划

Robert B. Watson
{"title":"应用API可用性的认知维度来改进API文档规划","authors":"Robert B. Watson","doi":"10.1145/2666216.2666239","DOIUrl":null,"url":null,"abstract":"This interactive poster explores the application of the 12 cognitive dimensions of API usability to API documentation planning by using the dimensions to identify and characterize the factors that influence the documentation that the users of an API require. Many factors can complicate estimating and planning the documentation an API requires. Even when an API's documentation requirements can be estimated, it can be difficult to present to stakeholders an objective basis for the estimate. The cognitive dimensions of API usability have characterized APIs and their users successfully and they have been used to communicate these characterizations to stakeholders. It follows that the same dimensions could also help identify the documentation that an API requires to provide a satisfactory and successful experience for the software developers who use the API.","PeriodicalId":393730,"journal":{"name":"Proceedings of the 32nd ACM International Conference on The Design of Communication CD-ROM","volume":null,"pages":null},"PeriodicalIF":0.0000,"publicationDate":"2014-09-27","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":"10","resultStr":"{\"title\":\"Applying the Cognitive Dimensions of API Usability to Improve API Documentation Planning\",\"authors\":\"Robert B. Watson\",\"doi\":\"10.1145/2666216.2666239\",\"DOIUrl\":null,\"url\":null,\"abstract\":\"This interactive poster explores the application of the 12 cognitive dimensions of API usability to API documentation planning by using the dimensions to identify and characterize the factors that influence the documentation that the users of an API require. Many factors can complicate estimating and planning the documentation an API requires. Even when an API's documentation requirements can be estimated, it can be difficult to present to stakeholders an objective basis for the estimate. The cognitive dimensions of API usability have characterized APIs and their users successfully and they have been used to communicate these characterizations to stakeholders. It follows that the same dimensions could also help identify the documentation that an API requires to provide a satisfactory and successful experience for the software developers who use the API.\",\"PeriodicalId\":393730,\"journal\":{\"name\":\"Proceedings of the 32nd ACM International Conference on The Design of Communication CD-ROM\",\"volume\":null,\"pages\":null},\"PeriodicalIF\":0.0000,\"publicationDate\":\"2014-09-27\",\"publicationTypes\":\"Journal Article\",\"fieldsOfStudy\":null,\"isOpenAccess\":false,\"openAccessPdf\":\"\",\"citationCount\":\"10\",\"resultStr\":null,\"platform\":\"Semanticscholar\",\"paperid\":null,\"PeriodicalName\":\"Proceedings of the 32nd ACM International Conference on The Design of Communication CD-ROM\",\"FirstCategoryId\":\"1085\",\"ListUrlMain\":\"https://doi.org/10.1145/2666216.2666239\",\"RegionNum\":0,\"RegionCategory\":null,\"ArticlePicture\":[],\"TitleCN\":null,\"AbstractTextCN\":null,\"PMCID\":null,\"EPubDate\":\"\",\"PubModel\":\"\",\"JCR\":\"\",\"JCRName\":\"\",\"Score\":null,\"Total\":0}","platform":"Semanticscholar","paperid":null,"PeriodicalName":"Proceedings of the 32nd ACM International Conference on The Design of Communication CD-ROM","FirstCategoryId":"1085","ListUrlMain":"https://doi.org/10.1145/2666216.2666239","RegionNum":0,"RegionCategory":null,"ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":null,"EPubDate":"","PubModel":"","JCR":"","JCRName":"","Score":null,"Total":0}
引用次数: 10

摘要

这张互动海报探讨了API可用性的12个认知维度在API文档规划中的应用,通过使用这些维度来识别和描述影响API用户所需文档的因素。许多因素会使API所需文档的估计和计划复杂化。即使可以估计API的文档需求,也很难向涉众提供评估的客观基础。API可用性的认知维度成功地描述了API及其用户的特征,并被用来与利益相关者沟通这些特征。因此,相同的维度还可以帮助确定API所需的文档,以便为使用该API的软件开发人员提供满意和成功的体验。
本文章由计算机程序翻译,如有差异,请以英文原文为准。
查看原文
分享 分享
微信好友 朋友圈 QQ好友 复制链接
本刊更多论文
Applying the Cognitive Dimensions of API Usability to Improve API Documentation Planning
This interactive poster explores the application of the 12 cognitive dimensions of API usability to API documentation planning by using the dimensions to identify and characterize the factors that influence the documentation that the users of an API require. Many factors can complicate estimating and planning the documentation an API requires. Even when an API's documentation requirements can be estimated, it can be difficult to present to stakeholders an objective basis for the estimate. The cognitive dimensions of API usability have characterized APIs and their users successfully and they have been used to communicate these characterizations to stakeholders. It follows that the same dimensions could also help identify the documentation that an API requires to provide a satisfactory and successful experience for the software developers who use the API.
求助全文
通过发布文献求助,成功后即可免费获取论文全文。 去求助
来源期刊
自引率
0.00%
发文量
0
期刊最新文献
Evidence of Things Not Seen: Mapping Sentiment in Unstructured Texts about the Herbicide 'Agent Orange' Architect, Developer, Designer: The Anatomy of UX in Industry Job Postings A Mobile Banking Model in the Cloud for Financial Inclusion in India Rhetorical Functions of Hashtag Forms Across Social Media Applications Social Justice in Technologies of Prenatal Care: Toward a User Centered Approach to Technical Communication in Home Pregnancy Testing
×
引用
GB/T 7714-2015
复制
MLA
复制
APA
复制
导出至
BibTeX EndNote RefMan NoteFirst NoteExpress
×
×
提示
您的信息不完整,为了账户安全,请先补充。
现在去补充
×
提示
您因"违规操作"
具体请查看互助需知
我知道了
×
提示
现在去查看 取消
×
提示
确定
0
微信
客服QQ
Book学术公众号 扫码关注我们
反馈
×
意见反馈
请填写您的意见或建议
请填写您的手机或邮箱
已复制链接
已复制链接
快去分享给好友吧!
我知道了
×
扫码分享
扫码分享
Book学术官方微信
Book学术文献互助
Book学术文献互助群
群 号:481959085
Book学术
文献互助 智能选刊 最新文献 互助须知 联系我们:info@booksci.cn
Book学术提供免费学术资源搜索服务,方便国内外学者检索中英文文献。致力于提供最便捷和优质的服务体验。
Copyright © 2023 Book学术 All rights reserved.
ghs 京公网安备 11010802042870号 京ICP备2023020795号-1