Am 2014-06-14 23:31, schrieb Daniel Stenberg:
On Fri, 13 Jun 2014, Daniel Stenberg wrote:
http://curl.haxx.se/docs/survey/survey2014.html
One of the most surprising results (to me) is that "docs" was voted the
most "worst area" in the project with a big margin. (Admittedly twice as
many also voted it as one of the best areas).
I'd like to understand this better. What exactly is considered bad and
what can we do about it? I think I'm having my nose a little too deep in
all the details to see this clearly. I was under the impression our
documentation was pretty good...
What's the biggest problem with the current docs? What's the biggest
thing we lack? Please share some ideas and thoughts here!
For instance, someone contributes code and docs and never reviews it
again. RFCs change, or get introduced, wording is bad or simply too much
text or even worse it is not written/implemented the way it should be.
For the spots I do use curl at work, would need an
improvement/unification/rework.
Michael
-------------------------------------------------------------------
List admin: http://cool.haxx.se/list/listinfo/curl-library
Etiquette: http://curl.haxx.se/mail/etiquette.html