Re: Crow Designer: updates of the GTK+ GUI builder project

[Maxim Udushlivy <crowdesigner org gmail com>]

On 6 December 2010 21:59, Robert Pearce <rob bdt-home demon co uk> wrote:

[rant mode]
 BOLLOX!

It is NEVER sufficient just to throw out a handful of examples and
claim it's good enough as API documentation. It may seem obvious to the
creator of the API, but that's JUST BECAUSE HE CREATED IT.

Q: What does this call do?
A: I passed it these parameters.
Q: But what do the parameters mean?
A: I passed it these parameters.
Q: And what difference would I see if I used 5 here?
A: I passed it these parameters.
Q: How do I change this appearance?
A: I like my appearance.

See? Not even slightly useful. But that's exactly the exchange you inflict
on your potential user by thinking examples are sufficient. There is NO
substitute for proper documentation.

[end rant]

Maybe Crow Designer's API really is trivially obvious, but I'm sceptical.

What was the reason of the "rant"? Do you demand documentation, Robert? If so, you'll have to wait.