It Will Never Work in Theory

Software development research that is relevant in practice

Browsing Posts in Documentation

Chris Parnin, Christoph Treude, Lars Grammel, and Margaret-Anne Storey. Crowd Documentation: Exploring the Coverage and the Dynamics of API Discussions on Stack Overflow. Georgia Tech Technical Report, 2012. Traditionally, many types of software documentation, such as API documentation, require a process where a few people write for many potential users. The resulting documentation, when it [...]

Martin P. Robillard and Rob DeLine. “A field study of API learning obstacles” ESE 16 (6), 2011. Large APIs can be hard to learn, and this can lead to decreased programmer productivity. But what makes APIs hard to learn? We conducted a mixed approach, multi-phased study of the obstacles faced by Microsoft developers learning a wide [...]