I like the way the Apache httpd server has it config files commented. it give you a example of what should go into the config. I user the paypal config as an example.
#payment.paypal.notify=http://[yourserver]/ecommerce/control/payPalNotify payment.paypal.notify= so the configuration person does not have to hunt down documentation when implementing these not so apparent configurations.