std.xml should just go

[spir]

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