David Lee Todd David Lee Todd, Unknown Product Manager
People who love sausages and software should never watch either being made

20060126 Thursday January 26, 2006

Undocumented APIs

I wonder what will happen if/when my product, eView Studio, is eventually open-sourced? I know that there is at least one of my more sophisticated customers who regularly decompiles our code, makes use of the classes they find there to call undocumented APIs, then calls us up to demand documentation for these classes when they don't work quite the way they wanted them to. One the one hand, exposing all the APIs will make it easy for these demands to arise; on the other hand, open code *should* make it easy for them to figure out the APIs' behavior themselves. We often leave classes undocumented to prevent customers from "shooting themselves in the foot." I guess Open Source has a certain libertarian bent, in which people are expected to be grown-up enough to take their own precautions. I would be interested to hear from managers of open-sourced products if this has been a problem for them.

Posted by davidleetodd ( Jan 26 2006, 11:11:25 AM PST ) Permalink

Comments:

Post a Comment:

Comments are closed for this entry.

Archives
Language
Links
Referrers