Artigo em revista científica Q1
Design annotations to improve API discoverability
André Santos (Santos, A. L.); Brad A. Myers (Myers, B. A.);
Título Revista
Journal of Systems and Software
Ano (publicação definitiva)
2017
Língua
Inglês
País
Estados Unidos da América
Mais Informação
Web of Science®

N.º de citações: 11

(Última verificação: 2024-11-19 18:19)

Ver o registo na Web of Science®


: 0.5
Scopus

N.º de citações: 11

(Última verificação: 2024-11-17 11:40)

Ver o registo na Scopus


: 0.4
Google Scholar

N.º de citações: 21

(Última verificação: 2024-11-17 19:01)

Ver o registo no Google Scholar

Abstract/Resumo
User studies have revealed that programmers face several obstacles when learning application programming interfaces (APIs). A considerable part of such difficulties relate to discovery of API elements and the relationships among them. To address discoverability problems, we show how to complement APIs with design annotations, which document design decisions in a program-processable form for types, methods, and parameters. The information provided by the annotations is consumed by the integrated development environment (IDE) in order to assist API users with useful code completion proposals regarding object creation and manipulation, which facilitate API exploration and learning. As a proof of concept, we developed Dacite, a tool which comprises a set of Java annotations and an accompanying plugin for the Eclipse IDE. A user study revealed that Dacite is usable and effective, and Dacite’s proposals enable programmers to be more successful in solving programming tasks involving unfamiliar APIs.
Agradecimentos/Acknowledgements
--
Palavras-chave
API usability,Annotations,Code completion,IDE,Eclipse
  • Ciências da Computação e da Informação - Ciências Naturais
Registos de financiamentos
Referência de financiamento Entidade Financiadora
HCC: Large: Collaborative Research: Variations to Support Exploratory Programming National Science Foundation
UID/MULTI/0446/2013 Fundação para a Ciência e a Tecnologia
HCC: Small: Better Tools for Authoring Interactive Behaviors National Science Foundation

Com o objetivo de aumentar a investigação direcionada para o cumprimento dos Objetivos do Desenvolvimento Sustentável para 2030 das Nações Unidas, é disponibilizada no Ciência-IUL a possibilidade de associação, quando aplicável, dos artigos científicos aos Objetivos do Desenvolvimento Sustentável. Estes são os Objetivos do Desenvolvimento Sustentável identificados pelo(s) autor(es) para esta publicação. Para uma informação detalhada dos Objetivos do Desenvolvimento Sustentável, clique aqui.