works without config.js, and improved docs
make changes suggested by matiu
Merge pull request #507 from maraoz/fix/config-defaults

works without config.js, and improved docs