When in Rome: Describing an API in its Own Terms with DITA 

To tame the API beast, a successful description must: be accurate and complete (of course); take the perspective of the programmer who's going to use the class.

Hennum, Erik and Mariana Alupului. STC Proceedings (2006). Presentations>Documentation>Standards>DITA