update configuration file documentation where necessary, and introduce new configuration README