Learning from api documentation and tutorials is challenging for many programmers. Improving the learnability of apis can reduce this barrier, especially for new programmers. We will use the tools of program analysis ...
详细信息
ISBN:
(纸本)9781450356282
Learning from api documentation and tutorials is challenging for many programmers. Improving the learnability of apis can reduce this barrier, especially for new programmers. We will use the tools of program analysis to extract key concepts and learning dependencies from api source code, api documentation, open source code, and other online sources of information on apis. With this information we will generate learning maps for any user-provided code snippet, and will take users through each concept used in the code snippet. Users may also navigate through the most commonly used features of an api without providing a code snippet. We also hope to extend this work to help users find the features of an api they need and also help them integrate that into their code.
Learning from api documentation and tutorials is challenging for many programmers. Improving the learnability of apis can reduce this barrier, especially for new programmers. We will use the tools of program analysis ...
详细信息
ISBN:
(纸本)9781538642351
Learning from api documentation and tutorials is challenging for many programmers. Improving the learnability of apis can reduce this barrier, especially for new programmers. We will use the tools of program analysis to extract key concepts and learning dependencies from api source code, api documentation, open source code, and other online sources of information on apis. With this information we will generate learning maps for any user-provided code snippet, and will take users through each concept used in the code snippet. Users may also navigate through the most commonly used features of an api without providing a code snippet. We also hope to extend this work to help users find the features of an api they need and also help them integrate that into their code.
Code examples are essential resources for learning application programming interfaces (apis). The shortage of such examples can be a major learning obstacle for api users. Writing and maintaining effective api usage e...
详细信息
ISBN:
(数字)9781665479561
ISBN:
(纸本)9781665479561
Code examples are essential resources for learning application programming interfaces (apis). The shortage of such examples can be a major learning obstacle for api users. Writing and maintaining effective api usage examples can also be an effort-intensive and repetitive process for api developers because api users ideally want such examples to be simple, standalone, and linear. To address these challenges, several approaches have been proposed to automatically extract api code examples from various resources and embed them into official api documents;however, little emphasis has been placed on addressing the underlying issue directly and helping api developers write and maintain api usage examples. In this paper, we present a new approach for automatically synthesising linear code examples from less repetitive versions by in-lining reusable utility methods. The proposed approach aims to benefit api developers in terms of productivity and maintainability, as well as api users in terms of api learnability and comprehension. We have implemented the proposed approach in a prototype for the Java programming language, which we also discuss in this paper.
Open Government datasets have been flooding the Web recently, and Application Programming Interfaces (apis) are key to the development of services on top of these datasets. An issue of current apis worldwide is that t...
详细信息
ISBN:
(纸本)9781450370240
Open Government datasets have been flooding the Web recently, and Application Programming Interfaces (apis) are key to the development of services on top of these datasets. An issue of current apis worldwide is that their learnability is limited. This work has explored the potential of querying apis using natural language terms to mitigate that issue. A user study with 20 participants has demonstrated that a natural-language-based, along with an order-agnostic approach to api design can produce easily learnable apis for both novice and experienced api users. These insights can pave the way for a paradigm change onWeb-api design for open geodata retrieval and beyond.
Almost all software development revolves around the discovery and use of application programming interfaces (apis). Once a suitable api is selected, programmers must begin the process of determining what functionality...
详细信息
ISBN:
(纸本)9781728108100
Almost all software development revolves around the discovery and use of application programming interfaces (apis). Once a suitable api is selected, programmers must begin the process of determining what functionality in the api is relevant to a programmer's task and how to use it. Our work aims to understand how api functionality is discovered by programmers and where tooling may be appropriate. We employed a mixed methods approach to investigate Apache Beam, a distributed data processing api, by mining Beam client code and running a lab study to see how people discover Beam's available functionality. We found that programmers' prior experience with similar apis significantly impacted their ability to find relevant features in an api and attempting to form a top-down mental model of an api resulted in less discovery of features.
暂无评论