Configuration system refactor: documentation

Update the documentation while refactoring Propel2 configuration system.
See https://github.com/propelorm/Propel2/pull/527
Merge pull request #296 from cristianoc72/config-refactor

Configuration system refactor: documentation