What makes APIs hard to learn? answers from developers

IEEE Software

Volumn 26, Issue 6, 2009, Pages 27-34

  Robillard, Martin P ^a  

^a MCGILL UNIVERSITY   (Canada)

Author keywords

API design; API usability; Application interfaces; Code examples; Context; Data mining; Documentation; Empirical study; Software documentation; Usability

Indexed keywords

API DESIGN; API USABILITY; APPLICATION INTERFACES; CODE EXAMPLES; CONTEXT; DOCUMENTATION; EMPIRICAL STUDY; SOFTWARE DOCUMENTATION; USABILITY;

COMPUTER SOFTWARE REUSABILITY; DESIGN;

APPLICATION PROGRAMMING INTERFACES (API);

EID: 70350602127     PISSN: 07407459     EISSN: None     Source Type: Journal    
DOI: 10.1109/MS.2009.193     Document Type: Article

References (9)

1. S.G. McLellan et al., "Building More Usable APIs," IEEE Software May/June 1998, pp. 78-86.
2. J. Stylos and S. Clarke, "Usability Implications of Requiring Parameters in Objects' Constructors," Proc. 29th Int'l Conf. Software Engineering (ICSE 07), IEEE CS Press, 2007, pp. 529-539.
3. K. Cwalina and B. Abrams, Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable. NET Libraries, 2nd ed., Addison-Wesley, 2009.
4. S. Clarke, "Measuring ANI Usability," Dr. Deb's J. Special Windows/.NET Supplement, May 2004.
5. J. Loch, "How to Design a Good ANI and Why It Matters," Companion to the 21st ACM SIGPLAN Symp. Object-Oriented Programming Systems, Languages, and Applications (OOPSLA 06), ACM Press, 2006, pp. 506-507.
6. B.A. Kitchenham and S.L. Pfleeger, "Chapter 3: Personal Opinion Surveys," Guide to Advanced Empirical Software Engineering, F. Shull, J. Singer, and D.I.K. Sjøberg, eds., Springer, 2008, pp. 63-92.
7. J. Nykaza et al., "What Programmers Really Want: Results of a Needs Assessment for SDK Documentation," Proc. 20th ACM SIGDOC Ann. Int'l Conf. Computer Documentation, IEEE CS Press, 2002, pp. 133-141.
8. R.S. Weiss, Learning from Strangers: The Art and Method of Qualitative Interview Studies, Free Press, 1994.
9. F. Shull, F. Lanubile, and V.R. Basili, "Investigating Reading Techniques for Object-Oriented Framework Learning," IEEE Trans. Software Eng., vol. 26, no. 11, 2000, pp. 1101-1118.