API documentation bibliography

My current list of API documentation-related articles listed with the newest article first.

The last line of each entry describes the:

  • Type of publication
  • Type of article
  • Type of API
  • Authors’ affiliations

Last update: 10 Sep 2018


5 Things Learned Generating API Documentation  (2018)

Delimarsky, Den

CS: blogPost on API Documentation

Professional, Editorial, Native API (.NET), Industry author(s)

API Documentation Best Practices  (2018)

Lakatos, Diana

TC: webpage on API Documentation

Professional, Tutorial, Not Specific API (Not Specific), Industry author(s)

A-Z of API Documentation  (2018)

TC: blogPost on API Documentation

Professional, Tutorial, Web API (REST), Industry author(s)

Development as a journey: factors supporting the adoption and use of software frameworks  (2018)

Myllärniemi, Varvana; Kujala, Sari; Raatikainen, Mikko; Sevo?n, Piia

CS: journalArticle on API Design

Academic, Survey, Not Specific API (Not Specific), Academic author(s)

How to generate your api documentation with Postman in 20 minutes  (2018)

Temitope, Olotin

TC: blogPost on API Documentation

Professional, Tool/Method, Web API (REST), Industry author(s)

Investigating type declaration mismatches in Python  (2018)

Pascarella, Luca; Ram, Achyudh; Nadeem, Azqa; Bisesser, Dinesh; Knyazev, Norman; Bacchelli, Alberto

CS: conferencePaper on API Documentation

Academic, Survey, Native API (Python), Academic author(s)

Writing Testable API Documentation Using APIB and Dredd  (2018)

Szmielew, Piotr

CS: webpage on API Documentation

Professional, Tool/Method, Web API (REST), Industry author(s)

10 Best Practices for Writing Node.js REST APIs | @RisingStack  (2017)

Nemeth, Gergely

CS: webpage on API Design

Professional, Tutorial, Web API (REST), Industry author(s)

API documentation  (2017)

De, Brajesh

CS: bookSection on API Documentation

Academic, Tutorial, Web API (REST), Industry author(s)

API Technical Writer – Hire For These 8 Skills Or Else…  (2017)

Gustafson, Peter

TC: webpage on API Documentation

Professional, Tutorial, Not Specific API (Not Specific), Industry author(s)

APIBot: Question answering bot for API documentation  (2017)

Tian, Yuan; Thung, Ferdian; Sharma, Abhishek; Lo, David

CS: conferencePaper on API Documentation

Academic, Tool/Method, Not Specific API (Not Specific), Academic author(s)

Application Programming Interface Documentation: What Do Software Developers Want?  (2017)

Meng, Michael; Steinhardt, Stephanie; Schubert, Andreas

TC: journalArticle on API Design

Academic, Survey, Not Specific API (Not Specific), Academic author(s)

Automated Generation of REST API Specification from Plain HTML Documentation  (2017)

Cao, Hanyang; Falleri, Jean-Rémy; Blanc, Xavier

CS: conferencePaper on API Documentation

Academic, Tool/Method, Web API (REST), Academic author(s)

Automation Is the Key for Agile API Documentation  (2017)

Riggins, Jennifer

CS: blogPost on API Documentation

Professional, Editorial, Web API (Not Specific), Industry author(s)

Best Practices in API Documentation  (2017)

Vasudevan, Keshav

CS: webpage on API Documentation

Professional, Tutorial, Web API (Not Specific), Industry author(s)

Choosing an NLP library for analyzing software documentation: a systematic literature review and a series of experiments  (2017)

Al Omran, Fouad Nasser A; Treude, Christoph

CS: conferencePaper on API Documentation

Academic, Experiment, Not Specific API (Not Specific), Academic author(s)

Components of Killer API Docs  (2017)

Flower, Zachary

CS: webpage on API Documentation

Professional, Tutorial, Web API (REST), Industry author(s)

Design annotations to improve API discoverability  (2017)

Santos, André L; Myers, Brad A

CS: journalArticle on API Documentation

Academic, Tool/Method, Not Specific API (Not Specific), Academic author(s)

Detecting near duplicates in software documentation  (2017)

Luciv, DV; Koznov, DV; Chernishev, GA; Terekhov, Andrey N

CS: journalArticle on API Documentation

Academic, Tool/Method, Not Specific API (Not Specific), Academic author(s)

Documentation Reuse: Hot or Not? An Empirical Study  (2017)

Oumaziz, Mohamed A; Charpentier, Alan; Falleri, Jean-Rémy; Blanc, Xavier

CS: conferencePaper on API Documentation

Academic, Survey, Native API (Java), Academic author(s)

Documenting APIs: A guide for technical writers | Document REST APIs  (2017)

Johnson, Tom

TC: webpage on API Documentation

Professional, Tutorial, Web API (REST), Industry author(s)

Duplicate management in software documentation maintenance  (2017)

Koznov, DV; Luciv, DV; Chernishev, GA

CS: conferencePaper on API Documentation

Academic, Tool/Method, Not Specific API (Not Specific), Academic author(s)

Generating method documentation using concrete values from executions  (2017)

Sulír, Matúš; Porubän, Jaroslav

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Good API Documentation Is Not About Choosing the Right Tool  (2017)

Locqueville, Maxime

TC: blogPost on API Documentation

Professional, Tutorial, Web API (Not Specific), Industry author(s)

Hierarchical RNN Networks for Structured Semantic Web API Model Learning and Extraction  (2017)

Liu, Shengpeng; Li, Ying; Sun, Guangyu; Fan, Binbin; Deng, Shuiguang

CS: conferencePaper on API Documentation

Academic, Tool/Method, Web API (REST), Academic author(s)

Learning Semantic Correspondences in Technical Documentation  (2017)

Richardson, Kyle; Kuhn, Jonas

CS: journalArticle on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Mining unit test cases to synthesize API usage examples  (2017)

Ghafari, Mohammad; Rubinov, Konstantin; Pourhashem K, Mohammad Mehdi

CS: journalArticle on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

On-demand developer documentation  (2017)

Robillard, Martin P; Marcus, Andrian; Treude, Christoph; Bavota, Gabriele; Chaparro, Oscar; Ernst, Neil; Gerosa, Marco Aurélio; Godfrey, Michael; Lanza, Michele; Linares-Vásquez, Mario

CS: conferencePaper on API Documentation

Academic, Editorial, Not Specific API (Not Specific), Academic author(s)

Preliminary Analysis of REST API Style Guidelines  (2017)

Murphy, Lauren; Alliyu, Tosin; Macvean, Andrew; Kery, Mary Beth; Myers, Brad A

CS: journalArticle on API Design

Academic, Survey, Various API (Various), Academic/Industry author(s)

Suggesting API Usage to Novice Programmers with the Example Guru  (2017)

Ichinco, Michelle; Hnin, Wint Yee; Kelleher, Caitlin L

TC: conferencePaper on API Documentation

Academic, User Study, Native API (Looking Glass), Academic author(s)

Ten Extras for Great API Documentation  (2017)

Lakatos, Diana

TC: webpage on API Documentation

Professional, Tutorial, Web API (REST), Industry author(s)

The smartAPI ecosystem for making web APIs FAIR  (2017)

Dastgheib, Shima; Whetzel, Trish; Zaveri, Amrapali; Afrasiabe, C; Assis, Pedro; Availlach, P; Jagodnik, Kathleen; Korodi, Gabor; Pilarczyk, Marcin; De Pons, Jeff

CS: conferencePaper on API Documentation

Academic, Tool/Method, Web API (REST), Academic author(s)

The Ten Essentials for Good API Documentation  (2017)

Lakatos, Diana

TC: webpage on API Documentation

Professional, Tutorial, Web API (REST), Industry author(s)

TMAP: Discovering relevant API methods through text mining of API documentation  (2017)

Pandita, Rahul; Jetley, Raoul; Sudarsan, Sithu; Menzies, Timothy; Williams, Laurie

CS: journalArticle on API Documentation

Academic, Tool/Method, Native API (Various), Academic/Industry author(s)

Towards Prioritizing Documentation Effort  (2017)

McBurney, Paul W; Jiang, Siyuan; Kessentini, Marouane; Kraft, Nicholas A; Armaly, Ameer; Mkaouer, Mohamed W; McMillan, Collin

CS: journalArticle on API Documentation

Academic, Tool/Method, Native API (Java), Academic/Industry author(s)

What is API Documentation, and Why It Matters?  (2017)

Vasudevan, Keshav

CS: webpage on API Documentation

Professional, Tutorial, Web API (Not Specific), Industry author(s)

API Best Practices: Documentation  (2016)

Lane, Kin

TC: webpage on API Documentation

Professional, Tutorial, Web API (REST), Industry author(s)

Augmenting API Documentation with Insights from Stack Overflow  (2016)

Treude, Christoph; Robillard, Martin P.

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Automated API Documentation with Tutorials Generated From Stack Overflow  (2016)

Rocha, Adriano M.; Maia, Marcelo A.

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Best Practices for Writing API Docs and Keeping Them Up To Date  (2016)

TC: webpage on API Documentation

Professional, Tutorial, Web API (REST), Industry author(s)

Five Questions Every Technical Writer Faces with API Documentation  (2016)

Marshall, Ed

TC: webpage on API Documentation

Professional, Editorial, Not Specific API (Not Specific), Industry author(s)

How to Write Good API Documentation  (2016)

MuleSoft

CS: webpage on API Documentation

Professional, Tutorial, Web API (REST), Industry author(s)

The Easiest Ways to Generate API Documentation | Nordic APIs |  (2016)

Wood, Chris

CS: webpage on API Documentation

Professional, Tutorial, Not Specific API (Not Specific), Industry author(s)

Tips for Documenting REST APIs – DZone Integration  (2016)

Pollock, John

TC: webpage on API Documentation

Professional, Tutorial, Web API (REST), Industry author(s)

An observational study on API usage constraints and their documentation  (2015)

Saied, M. A.; Sahraoui, H.; Dufour, B.

CS: conferencePaper on API Documentation

Academic, Survey, Native API (Java), Academic author(s)

Best practices and UX tips for API documentation  (2015)

Nagygyörgy, Katalin

TC: webpage on API Documentation

Professional, Tutorial, Web API (Not Specific), Industry author(s)

How API Documentation Fails  (2015)

Uddin, G.; Robillard, M. P.

CS: journalArticle on API Documentation

Professional, Survey, Native API (Not Specific), Academic/Industry author(s)

How to Write “Good” API Documentation  (2015)

Kerby, Natalie

TC: webpage on API Documentation

Professional, Tutorial, Web API (Not Specific), Industry author(s)

Recommending reference API documentation  (2015)

Robillard, Martin P; Chhetri, Yam B

CS: journalArticle on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Spyrest: Automated restful API documentation using an HTTP proxy server (N)  (2015)

Sohan, Sheikh Mohammed; Anslow, Craig; Maurer, Frank

CS: conferencePaper on API Documentation

Academic, Survey, Not Specific API (Not Specific), Academic author(s)

The Best API Documentation  (2015)

Fults, Brad

TC: webpage on API Documentation

Professional, Tutorial, Web API (Not Specific), Industry author(s)

The Effect of Visual Design and Information Content on Readers’ Assessments of API Reference Topics  (2015)

Watson, Robert Bennett

TC: thesis on API Documentation

Academic, Experiment, Native API (Not Specific), Academic author(s)

API Technical Writing  (2014)

Sarah Maddox

TC: presentation on API Documentation

Professional, Tutorial, Not Specific API (Not Specific), Industry author(s)

How do api documentation and static typing affect api usability?  (2014)

Endrikat, Stefan; Hanenberg, Stefan; Robbes, Romain; Stefik, Andreas

CS: conferencePaper on API Documentation

Academic, Experiment, Native API (Not Specific), Academic author(s)

Live API documentation  (2014)

Subramanian, Siddharth; Inozemtseva, Laura; Holmes, Reid

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Who Asked What: Integrating Crowdsourced FAQs into API Documentation  (2014)

Chen, Cong; Zhang, Kang

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Writing API Documentation with Slate  (2014)

White, Lukas

TC: blogPost on API Documentation

Professional, Tool/Method, Web API (REST), Industry author(s)

API Documentation – Why it sucks  (2013)

Parnin, Chris

CS: webpage on API Documentation

Professional, Case Study, Native API (Android), Academic author(s)

API documentation and software community values: a survey of open-source API documentation  (2013)

Watson, Robert; Mark Stamnes, Mark; Jeannot-Schroeder, Jacob; Spyridakis, Jan H

TC: conferencePaper on API Documentation

Academic, Survey, Not Specific API (Not Specific), Academic author(s)

Detecting API documentation errors  (2013)

Zhong, Hao; Su, Zhendong

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Generating API-usage Example for Project Developers  (2013)

Zhu, Zixiao; Zou, Yanzhen; Jin, Yong; Xie, Bing

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

How to become an API technical writer | ffeathers  (2013)

Maddox, Sarah

TC: webpage on API Documentation

Professional, Editorial, Not Specific API (Not Specific), Industry author(s)

Patterns of Knowledge in API Reference Documentation  (2013)

Maalej, W.; Robillard, M.P.

CS: journalArticle on API Documentation

Academic, Tool/Method, Native API (Java, .NET), Academic author(s)

Validation and interactivity of web API documentation  (2013)

Danielsen, Peter J; Jeffrey, Alan

CS: conferencePaper on API Documentation

Academic, Tool/Method, Web API (REST), Industry author(s)

Writing API Documentation in an Agile Environment  (2013)

Fingold, Jonathan

TC: webpage on API Documentation

Professional, Editorial, Not Specific API (Not Specific), Industry author(s)

Automated information extraction from web APIs documentation  (2012)

Ly, Papa Alioune; Pedrinaci, Carlos; Domingue, John

CS: conferencePaper on API Documentation

Academic, Tool/Method, Web API (Not Specific), Academic author(s)

Crowd documentation: Exploring the coverage and the dynamics of API discussions on Stack Overflow  (2012)

Parnin, Chris; Treude, Christoph; Grammel, Lars; Storey, Margaret-Anne

CS: journalArticle on API Documentation

Academic, Tool/Method, Native API (Android), Academic author(s)

Designing Great API Docs  (2012)

Yu, James

TC: webpage on API Documentation

Professional, Tutorial, Not Specific API (Not Specific), Industry author(s)

Developing best practices for API reference documentation: Creating a platform to study how programmers learn new APIs  (2012)

Watson, R.

TC: conferencePaper on API Documentation

Academic, Tool/Method, Not Specific API (Not Specific), Academic author(s)

Development and application of a heuristic to assess trends in API documentation  (2012)

Watson, R.B.

TC: conferencePaper on API Documentation

Academic, Tool/Method, Web API (JavaScript), Academic author(s)

Extracting models from web API documentation  (2012)

Rodríguez, Rolando; Espinosa, Roberto; Bianchini, Devis; Garrigós, Irene; Mazón, Jose-Norberto; Zubcoff, Jose

CS: journalArticle on API Documentation

Academic, Tool/Method, Web API (Not Specific), Academic author(s)

Facing up to the Inequality of Crowdsourced API Documentation  (2012)

Jiau, Hewijin Christine; Yang, Feng-Pu

CS: journalArticle on API Documentation

Academic, Case Study, Web API (Not Specific), Academic author(s)

How to Write Good Object-oriented API Documentation  (2012)

Monperrus, Martin

CS: webpage on API Documentation

Professional, Tutorial, Native API (Java), Academic author(s)

REST API Documentation Best Practices – software development process, training, tutorial, web applications – Bocoup  (2012)

Ros, Irene

TC: webpage on API Documentation

Professional, Tutorial, Web API (REST), Industry author(s)

Synthesizing API usage examples  (2012)

Buse, Raymond PL; Weimer, Westley

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

What makes a good code example?: A study of programming Q&A in StackOverflow  (2012)

Nasehi, Seyed Mehdi; Sillito, Jonathan; Maurer, Frank; Burns, Chris

CS: conferencePaper on API Documentation

Academic, Tool/Method, Not Specific API (Not Specific), Academic author(s)

What should developers be aware of? An empirical study on the directives of API documentation  (2012)

Monperrus, Martin; Eichberg, Michael; Tekes, Elif; Mezini, Mira

CS: journalArticle on API Documentation

Academic, Case Study, Native API (Java), Academic author(s)

Why We Write API Documentation  (2012)

Gruenbaum, Peter

CS: webpage on API Documentation

Professional, Editorial, Not Specific API (Not Specific), Industry author(s)

A field study of API learning obstacles  (2011)

Robillard, M.P.; DeLine, R.

CS: journalArticle on API Design

Academic, User Study, Native API (Windows), Academic/Industry author(s)

An empirical study on evolution of API documentation  (2011)

Shi, Lin; Zhong, Hao; Xie, Tao; Li, Mingshu

CS: journalArticle on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

API design for humans  (2011)

Lorang, Noah

CS: webpage on API Design

Professional, Tutorial, Web API (Rest), Industry author(s)

Measuring api documentation on the web  (2011)

Parnin, Chris; Treude, Christoph

CS: conferencePaper on API Documentation

Academic, Tool/Method, Web API (Jquery), Academic author(s)

Recommending proper API code examples for documentation purpose  (2011)

Mar, Lee Wei; Wu, Ye-Chi; Jiau, Hewijin Christine

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Unknown author(s)

The role of conceptual knowledge in API usability  (2011)

Ko, A.J.; Riche, Y.

CS: conferencePaper on API Design

Academic, User Study, Native API (Not Specific), Academic/Industry author(s)

Writing helpful API documentation  (2011)

Mihaly, Ferenc

TC: blogPost on API Documentation

Professional, Tutorial, Native API (Not Specific), Industry author(s)

CoDocent: Support API usage with code example and API documentation  (2010)

Wu, Ye-Chi; Mar, Lee Wei; Jiau, Hewijin Christine

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Incorporating Usability into the API Design Process  (2010)

Watson, Robert

TC: bookSection on API Design

Academic, Tool/Method, Native API (Not Specific), Industry author(s)

MSDN Magazine: “Hello World!” A Coder’s Guide to Writing API Documentation  (2010)

Gruenbaum, Peter

TC: webpage on API Documentation

Professional, Tutorial, Native API (C#), Industry author(s)

Recommending source code examples via api call usages and documentation  (2010)

McMillan, Collin; Poshyvanyk, Denys; Grechanik, Mark

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic/Industry author(s)

Tool support for crosscutting concerns of API documentation  (2010)

Horie, Michihiro; Chiba, Shigeru

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Web API Documentation Best Practices  (2010)

Gruenbaum, Peter

CS: webpage on API Documentation

Professional, Tutorial, Web API (REST), Industry author(s)

What do you consider good API documentation?  (2010)

Various

CS: webpage on API Documentation

Professional, Tutorial, Native API (Not Specific), Industry author(s)

Improving API documentation usability with knowledge pushing  (2009)

Dekel, Uri; Herbsleb, James D

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Improving software API usability through text analysis: A case study  (2009)

Watson, Robert B

TC: conferencePaper on API Design

Academic, Tool/Method, Native API (C#), Industry author(s)

Inferring resource specifications from natural language API documentation  (2009)

Zhong, Hao; Zhang, Lu; Xie, Tao; Mei, Hong

CS: conferencePaper on API Design

Academic, Tool/Method, Native API (Java), Academic author(s)

Jadeite: improving API documentation using usage information  (2009)

Stylos, Jeffrey; Myers, Brad A; Yang, Zizhuang

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

What makes apis hard to learn? answers from developers  (2009)

Robillard, Martin P

CS: journalArticle on API Design

Professional, Survey, Native API (Windows), Academic/Industry author(s)

Opportunistic programming: How rapid ideation and prototyping occur in practice  (2008)

Brandt, Joel; Guo, Philip J; Lewenstein, Joel; Klemmer, Scott R

CS: conferencePaper on Developer Study

Academic, User Study, Native API (PHP), Academic author(s)

API design matters  (2007)

Henning, M.

CS: journalArticle on API Design

Professional, Editorial, Native API (C#), Industry author(s)

How to design a good API and why it matters  (2006)

Bloch, J.

CS: conferencePaper on API Design

Academic, Tutorial, Native API (Not Specific), Industry author(s)

Mica: A web-search tool for finding API components and examples  (2006)

Stylos, J.; Myers, B.A.

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Why Are APIs Difficult to Learn and Use?  (2006)

Scaffidi, Christopher

CS: journalArticle on API Design

Professional, Tool/Method, Native API (C/C++), Academic author(s)

Profiling software API usability for consumer electronics  (2005)

Bore, C; Bore, S

CS: conferencePaper on API Design

Academic, Tool/Method, Native API (Not Specific), Industry author(s)

Measuring API Usability  (2004)

Clarke, Steven

CS: webpage on API Design

Professional, Tool/Method, Native API (C#), Industry author(s)

API documentation with executable examples  (2003)

Hoffman, Daniel; Strooper, Paul

CS: journalArticle on API Documentation

Academic, Tool/Method, Native API (Java), Academic author(s)

Documenting C, C++ and Java Software from GUI to API  (2003)

Darrow, John

CS: book on API Documentation

Professional, Tutorial, Native API (Not Specific), Academic author(s)

Automatically connecting documentation to code with rose  (2002)

Pierce, Robert; Tilley, Scott

TC: conferencePaper on API Documentation

Academic, Tool/Method, Native API (C/C++), Academic/Industry author(s)

Using Javadoc and XML to produce API reference documentation  (2002)

Leslie, Donald M

CS: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Industry author(s)

Creating an SDK: Writing on the edge  (2001)

Sarr, J.T.

TC: journalArticle on API Documentation

Professional, Tutorial, Native API (Not Specific), Industry author(s)

API documentation from source code comments: a case study of Javadoc  (1999)

Kramer, Douglas

TC: conferencePaper on API Documentation

Academic, Tool/Method, Native API (Java), Unknown author(s)

Building more usable APIs  (1998)

McLellan, S.G.; Roesler, A.W.; Tempest, J.T.; Spinuzzi, C.I.

CS: journalArticle on API Design

Professional, Usability test, Native API (C/C++), Academic/Industry author(s)

The design of distributed hyperlinked programming documentation  (1996)

Friendly, Lisa

CS: bookSection on API Documentation

Academic, Tool/Method, Native API (Java), Industry author(s)