add some settings clarification
fix config for heroku
better logging
saves all_required
condense and cleanup code