Re: saving a URL/newbie rant (libwww)
On May 22, 7:25pm, Sacha wrote:
> Ok. It is clear that I haven't really understood what on earth is going
> on. I think the real problem is that I haven't really grasped most of
> what comes in the documentation, because it lacks a really good
> from-the-top intro for clueless-people-with-no-knowledge-of-anything.
> When I started using the lib I tried to read the documentation to figure
> out how to get going, but I found that basically it said "Play with the
> examples", then went off into the deep end describing bits of the
> architecture, then left me to pore through the code trying to figure out
> what the hell was going on.
> I don't know if I'm the only one who feels this way, ...
My experience has been similar. I have found this software to be
very difficult to use. It is missing the three most important things
needed for a usable system:
1. Accurate, complete, usable documentation.
The documentation is only about half finished and what is there is
often inaccurate or out of date. Plus, of course, HTML is a completely
inappropriate format for long documents--how about using a real
documentation system, guys? You know--page numbers, running headers,
table of contents, and index, etc. FrameMaker would be fine...
As for testing, it appears there is none at all. And, by the way,
testing by the authors doesn't count. I've tried that and it doesn't
work. I'm talking about automated testing done by a separate department.
As for support, Henrik tries, but he is way overworked. I have sent
in bug reports with complete Purify traces and never even gotten an
acknowledgement. It is not an efficient use of time or money when
developers do support.
In summary, the WWW Consortium is run like a university research
project, not like a professional software organization. This is a
very sad state of affairs, since they seem unable to properly
deliver and support their own code. The root of the problem is
they are overworking expensive resources like Henrik when they
should be hiring doc, QA and tech support people.
Unfortunately, I can't really offer constructive suggestions for
this problem since I'm not privy to the internal workings and
budget of the Consortium. All I can say is they are not serving
their customers very well. Overall I'd have to give them a 'D'.
I only wish I had an alternative other than writing this stuff
from scratch myself.