By Topic

What Makes APIs Hard to Learn? The Answers of Developers

Sign In

Cookies must be enabled to login.After enabling cookies , please use refresh or reload or ctrl+f5 on the browser for the login options.

Formats Non-Member Member
$33 $13
Learn how you can qualify for the best price for this item!
Become an IEEE Member or Subscribe to
IEEE Xplore for exclusive pricing!
close button

puzzle piece

IEEE membership options for an individual and IEEE Xplore subscriptions for an organization offer the most affordable access to essential journal articles, conference papers, standards, eBooks, and eLearning courses.

Learn more about:

IEEE membership

IEEE Xplore subscriptions

Most software projects reuse components exposed through Application Programming Interfaces (APIs), which provide developers with access to implemented functionality. APIs have grown large and diverse, raising the question of how usable they really are. This article reports on a study of the obstacles professional developers at Microsoft faced when learning how to use APIs. The study was grounded in developers' experience, collected through a survey and interviews. The resulting data showed that resources for learning an API were critically important, and shed light on three API learning obstacles: The need discover the design and rationale of the API on a need-to-know basis, the challenge of finding credible usage API examples at the right level of complexity, and the challenge of understanding inexplicable API behavior. The article describes each of these challenges in detail, and discusses associated implications for API users and designers.

Published in:

IEEE Software  (Volume:PP ,  Issue: 99 )