Blog

8 August 2014 - Embracing Discrimination (in API Documentation)

A flat (non-hierarchical) content presentation mostly assumes the reader wants to read everything sequentially. This assumption is fine for suspenseful novels, but it crumples in the case of API documentation...

26 June 2014 - Good Practices for Software Analytics Papers

Much effort is currently invested to increase our understanding of software development by analyzing large data sets [...]. This type of effort is now known as Software Analytics [...]. We [provide] a list of desirable practices for reporting on software analytics projects.

12 May 2014 - APIs: What Should We Document (and Not Document)?

APIs are not always self-explanatory, so we need to complement them with documentation for better usability...But how do we do that? ...