On Jul 27, 2010, at 12:01 PM, James Godrej wrote:
James, We're always very welcoming of new contributors on the Apache documentation mailing list. While we acknowledge that updates are always in order, your remark isn't exactly helpful, because it doesn't suggest what, specifically, you find to be problematic with the referenced document. The example given is: ProxyVia Off That's the entirety of the example, because that's the full usage of the directive. The document goes on to explain that possible settings, other than Off, include On, Full, and Block. Itemizing each of these as separate examples, we could presumably say: ProxyVia On - or - ProxyVia Full - or - ProxyVua Block However, we do assume that readers of the documentation have some grasp of Apache configuration files, and can tell from the one example, and the itemized list of alternative values, what the directive would look like with each of the other possible settings. Or, said differently, it's impossible to provide every possible example configuration, and so we assume that our readers are able to generalize. An inability to generalize documentation examples tends to lead to support situations where you're holding someone's hand through every configuration change, which is something we'd quite frankly like to avoid. However, if you'd like to submit changes to the documentation, please feel free to do so. We prefer that diffs be against the 2.2 or trunk docs, rather than against 2.0, which is no longer the recommended version of our product. Thanks. |
|