documented a bit more and fixed a typo in production.rb