Improved documentation of outcome method in logic.rb