Fix where the documentation says "photos", but the example shows "posts" or "comments" by switching both to simply "posts"

Add further documentation + examples for the get, post, put and delete methods in ActionDispatch::Routing::Mapper::HttpHelpers

Signed-off-by: NSantiago Pastorino <santiago@wyeworks.com>

Signed-off-by: NJosé Valim <jose.valim@gmail.com>

[#5784 state:resolved]
Signed-off-by: NJosé Valim <jose.valim@gmail.com>

make sure request parameters are accessible after rack throws an exception parsing the query string [#3030 state:resolved]
Signed-off-by: NJosé Valim <jose.valim@gmail.com>

only forwarding enough methods to work. People should grab the delegate tempfile if they really need to do hard work

Sometimes it's easier to define routes inside Engine or
Application class definition (e.g. one file applications). The
problem with such case is that if there is a plugin that
has config/routes.rb file, it will trigger routes reload on application.
Since routes definition for application is not in config/routes.rb
file routes_reloader will fail to reload application's routes
properly. With this commit you can pass routes definition as a block
to routes method, which will allow to properly reload it:

class MyApp::Application < Rails::Application
  routes do
    resources :users
  end
end

Without that commit script_name always become '/', which
results in paths like //posts/1 instead of /posts/1

'The scheme name consists of a letter followed by any combination of letters, digits, and the plus ("+"), period ("."), or hyphen ("-") characters; and is terminated by a colon (":").'