Better error message if repo is not started

Closes #248.
Clarify that :build_per_environment defaults to true.
Merge pull request #255 from MSch/better-docs

Clarify that :build_per_environment defaults to true.