On Thu, Nov 16, 2006 at 05:03:29PM +0100, Rainer Jung wrote: > It's not the right list to discuss, but:
> As a user I would expect configuration info for load-balancing with > mod_proxy_balancer on the mod_proxy_balancer page. > The fact, that all configurations for the proxy balancer are done by > attributes, and the only full size apache directives concerning > mod_proxy_balancer are in fact handled by mod_proxy unfortunately > leads to the result, that the doc is only on the mod_proxy page. > The user doesn't yet know, that he wants to use ProxyPass, he only > knows he wants to add load balancing and looks at the page of > mod_proxy_balancer, because this component is supposed to implement > the balancing. At this point the user usually hasn't read the code > to find out, that the configs are in fact handled by mod_proxy > itself :) There are at least several underlying issues. At the top of the list, I would put that apache.org does not have an overall design of the relationships between the various categories of information. Basically, information is burped out into a category, based on someone's assessment of where it belongs. But, without a plan in place to link that information to all the other categories to which it would be relevant, those links are only made when it happens to occur to that hypothetical "someone" that they should be in there. At least, that is the way it appears to this "someone" from the outside. apache.org is, fundamentally, a gigantic, unindexed reference manual. If you need the technical information about a <directive>, you've got it. If you need to know which directive to use, it is not the best first place to look. Unfortunately, when you depend on third parties to produce your user documentation, the most widely-read documentation is going to be far behind the development (_Tomcat: The Definitive Guide_, last updated 2003). Yes, of course, there are all kinds of reasons why this turned out to be this way. I won't go on beating up on the ASF. I just want the this great software project and all its worthwhile subprojects to have a web site that reflects the quality of the product. And, in particular, of course, to have the information I want when I want it!! ;-) Thanks. mp -- Michael Powe [EMAIL PROTECTED] Naugatuck CT USA And your crybaby whiny opinion would be.....?
pgpdpL1KGY6FE.pgp
Description: PGP signature
