Our Research on API Documentation

Modern software development means constantly using powerful libraries and frameworks (APIs). Good documentation of these reusable packages is obviously important for realizing their potential benefits.

We want to explore these questions in this research area which we started in 2014.

Styles of API documentation

Maalej and Robillard have devised a set of 12 information types that form a simple taxononmy of nearly everything that can be found in API documentation. They have counted how frequent each type is in the elements of the Java standard library documentation and the .NET standard library documentation.

We have replicated their study for the Python standard library, because we suspect that the Python documentation uses a distinctly different approach. We want to characterize the difference and later also determine its impact on the usefulness of the documentation.

This work is ongoing. There are no publications yet.

API documentation references on Stack Overflow

We want to understand whether and how the quality

This work is ongoing. There are no publications yet.

Comments