On Thu, May 14, 2009 at 5:04 PM, Ariel Constenla-Haile <[email protected]> wrote:
Hi Ariel, > In general, that's not true. For writing serious documentation you need some > information about its implementation; but API user only know the specification > and how to use the API. I disagree here. Sometimes I develop OO.o internals and sometimes I develop extension. From the extension developer point of view (API client), it is much better if documentation is written by someone who uses this API. Sometimes it's unclear how to use it and if you (as a client) do know how to use it, you can write documentation (even uncomplete) for the same people = again, API clients. Your documentation will be for sure better than documentation of someone who did wrote these classes, methods, ... because you already know it from client perspective. -- Robert Vojta --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
