Unit tests as API usage examples

Simple item page
dc.contributor.authorNasehi, S.M.
dc.contributor.authorMaurer, F.
dc.date.accessioned2015-07-29T19:39:53Z
dc.date.available2015-07-29T19:39:53Z
dc.date.issued2010
dc.description.abstractThis study aims to find out if API unit tests can provide good usage examples, and if so, what prevents developers from finding and using those examples. The results of an experiment we performed with two groups of developers showed that unit tests can be very helpful, especially when the task is complicated and involves multiple classes and methods. Well-written tests proved to be a good source of examples, but finding the relevant examples using the standard tools might be very difficult. We propose to supplement the standard API documentation with relevant examples taken from the unit tests. To further improve the learnability of the API, presentation of the documentation and examples has to be tailored in a way that separates or hides advanced usage scenarios from the commonly used ones.en_US
dc.description.refereedYesen_US
dc.identifier.doi10.1109/ICSM.2010.5609553
dc.identifier.urihttp://hdl.handle.net/1880/50715
dc.publisherIEEEen_US
dc.publisher.urlhttp://dx.doi.org/10.1109/ICSM.2010.5609553en_US
dc.titleUnit tests as API usage examplesen_US
dc.typeunknown
Files
License bundle
Now showing 1 - 1 of 1
Thumbnail Image
Name:
license.txt
Size:
1.84 KB
Format:
Item-specific license agreed upon to submission
Description:
Download
Collections
Surfnet