Re: Our documentation sucks

[wjw]

I am with you all the way on this jimt. My delve into the land of XML has been nightmarish. It really does me no good to have module docs that point back to the W3C standard and says "read 'em". An XML file is not that tough to understand, and neither are the rules that make it good or bad. Many of the docs seem to assume one has the time to research the guts of the underlying technology. If I had that kind of time, I would in fact write my own module! Use cases are badly needed. I admit I am not the consummate programmer, and never will be. But when I can write my own mod that finds things in an XML file using regex's faster than I can figure out the module that is supposed to do the work for me, there is a problem.

I want to be clear that I am not faulting those that put all the work into writing these modules. I am frankly astounded at what it must have taken to accomplish this, and I wish I was that damn good. The only reason I pick on the XML stuff is because it is what I have been banging my head against for some time now.

Thanks for saying what I have been thinking for a while jimt.

I also recognize the value of the points that were made by others, but I gotta lean towards the validity of jimt's post.