An idea on writing readable controller code.

idea_controller.rb

# ActionController#action arguments as documentation.
#
# I've been writing controller#action method definitions with inline arguments
# on a recent project. I started taking this approach to provide an at-a-glance
# "documentation" on what inputs an action is expecting to interact with in
# the course of it's execution.
class IdeaController < ActionController::Base
  
  def take_action(email = params[:email], password = params[:password])
    # Take some action with email and password
  end

end