Article Discussion
Using a Decision Tree to Navigate Complex APIs
Summary: As software products become more complex, developers must invest increasing amounts of time to learn about new API and product capabilities. Traditional documentation tools were not designed to help navigate that increasingly complex landscape. This article reports on an interactive documentation navigator developed by Business Objects, S.A., for their Crystal Reports and enterprise reporting-related products. That documentation tool not only presents API components and describes how to use classes and methods of an API, but also guides a developer through the decisions of what API elements to use to accomplish a given task.
0 posts.
The ability to add new comments in this discussion is temporarily disabled.
    Admin
     
    Posts: 15 / Nickname: admin / Registered: January 17, 2002 3:57 PM
    Using a Decision Tree to Navigate Complex APIs
    May 25, 2005 8:00 PM      
    As software products become more complex, developers must invest increasing amounts of time to learn about new API and product capabilities. Traditional documentation tools were not designed to help navigate that increasingly complex landscape. This article reports on an interactive documentation navigator developed by Business Objects, S.A., for their Crystal Reports and enterprise reporting-related products. That documentation tool not only presents API components and describes how to use classes and methods of an API, but also guides a developer through the decisions of what API elements to use to accomplish a given task.

    http://www.artima.com/articles/decisiontree.html

    What is your opinion about using a decision tree to help people find their way through complex API documentation? What other approaches do you think would help developers deal with the increasing complexity of APIs?