How API Documentation Fails

Formal documentation can be a crucial resource for learning to how to use an API. However, producing high-quality documentation can be nontrivial. Researchers investigated how 10 common documentation problems manifested themselves in practice. The results are based on two surveys of a total of 323 p...

Celý popis

Uloženo v:
Podrobná bibliografie
Vydáno v:IEEE software Ročník 32; číslo 4; s. 68 - 75
Hlavní autoři: Uddin, Gias, Robillard, Martin P.
Médium: Journal Article
Jazyk:angličtina
Vydáno: Los Alamitos IEEE 01.07.2015
IEEE Computer Society
Témata:
API
Application programming interface
Application programming interfaces
Documentation
Failure analysis
Software development
software engineering
Studies
Uniform resource locators
user study
ISSN:0740-7459, 1937-4194
On-line přístup:Získat plný text
Tagy: Přidat tag
Žádné tagy, Buďte první, kdo vytvoří štítek k tomuto záznamu!
Popis
Shrnutí:Formal documentation can be a crucial resource for learning to how to use an API. However, producing high-quality documentation can be nontrivial. Researchers investigated how 10 common documentation problems manifested themselves in practice. The results are based on two surveys of a total of 323 professional software developers and analysis of 179 API documentation units. The three severest problems were ambiguity, incompleteness, and incorrectness of content. The respondents often mentioned six of the 10 problems as "blockers"' that forced them to use another API.
Bibliografie:SourceType-Scholarly Journals-1
ObjectType-Feature-1
content type line 14
ISSN:0740-7459
1937-4194
DOI:10.1109/MS.2014.80