[ci skip]

This is a small breaking change that we chose to make in 5.1 since the
fix can be done with a search and replace tool.

Since using a `ActiveSupport::Deprecation::DeprecatedConstantProxy`
would prevent people from inheriting this class and extending it
from the `ActiveSupport::HashWithIndifferentAccess` one would break
the ancestors chain, that's the best option we have here.

guide

ref #26404

[ci skip]

This reverts commit 6961afef.

We were not able to keep backward compatibility in this case so it is
better to ask people to upgrade with cold cache.

Is this usage correct? cc/ @prathamesh-sonpatki

Listening to a few developers today discussing their troubles in understanding how to use the asset pipeline, it turns out that the precompile examples in the guides and assets.rb template have over time become a bit inconsistent.

This PR makes the examples consistent in code style, spacing, and asset names, removes the old 'swfObject.js' example, and in a couple of places wraps lines at 80 characters including in the assets.rb template.

Re-add spaces inside array parentheses.

Reason: See https://github.com/rails/rails/pull/26163#issuecomment-239703322

This reverts commit 39effc85.

The Guides section about autoloading being disabled was slightly confusing
(#24724) and didn't directly reference the removed feature by name
(config.autoload_paths) making it much harder for someone to search the upgrade
guides for a mention or serendipitously find it via a Google search when running
into autoloading issues.

I also fixed some confusing turns of phrase and a missing word.

/cc @vipulnsward @jvanbaarsen

Fix a small typo on doc: "caches_pages" -> "caches_page".

See issue #25581:

https://github.com/rails/rails/issues/25581

From the style guide:
When writing headings, capitalize all words except for prepositions,
conjunctions, internal articles, and forms of the verb "to be":

- Also to_time_preserves_timezone config should be false for older apps getting upgraded to Rails 5 [ci skip]

Mentions missing config options and fixes headers for section talking
about new framework defaults.

It's useful to have a link to the release notes in the upgrade guide for
a clearer view of what changed in Rails.

Adds missing upgrade items to the upgrade guides for Rails 5. Fixes some
typos and whitespace as well.

Ruby 2.4 unifies Fixnum and Bignum into Integer: https://bugs.ruby-lang.org/issues/12005

* Forward compat with new unified Integer class in Ruby 2.4+.
* Backward compat with separate Fixnum/Bignum in Ruby 2.2 & 2.3.
* Drops needless Fixnum distinction in docs, preferring Integer.

[ci skip]

- Change from "The Task" to "The Update Task" as referred elsewhere

[ci skip]

`rails:update` was deprecated in 6fb31638

This guides were pointing to this command `rails app:update`, which I
tried to run, but it didnt worked. I think the right command is `rails
rails:update` instead. Also thats the name of the rake task.

Also I removed the `Rake` word from the title, as we run it using
`rails` bin now.

cc @kaspth
[skip ci]

(e.g. `rails:update` and `rails:template` tasks is renamed to `app:update` and `app:template`.)