On 02/03/2011 11:10 PM, Daniel Gibson wrote:
Claiming that looking at the documentation isn't sufficient to understand how
the API works (from a users point of view, not internally) is pretty stupid:
1. it insults the modules author(s) ("You're too stupid to write meaningful
documentation")
2. even if the documentation sucks one may have understood how to the API is
used by looking at code examples using it...
There is an obvious loophole in their argumentation: what if the author of the
new lib has used the old one for years: thus perfectly understands the API from
the client side, and certainly has a good idea of how it may well be
implemented, even more beeing a library author (even more since client &
implementation languages are the same in this case).
Denis
--
_________________
vita es estrany
spir.wikidot.com
