Configuration system refactor: documentation

Update the documentation while refactoring Propel2 configuration system.
See https://github.com/propelorm/Propel2/pull/52