clarify that the contents of the block is expected to return a string. the previous example executed puts and the initializer got nothing.

also, made it consistent with the single-line example to be more clear as to what's going on

see: https://github.com/blog/1406-namespaced-gists

There's no reason for guides to reference old behaviors. They should
be current as of the versions of Rails that they ship with, and including
older information just clutters thing.

I discussed this change with @fxn and he agrees.

We have three or four different introduction sentences to the guides.
After this commit, we use the same one everywhere.

Talked with @fxn about this. Bullet points should have periods at the ends.

This reverts commit f5b9ed4f.

REASON: Translation work can not be done in the docrails repository

Change the default test locations to avoid confusion around the common
testing terms "unit" and "functional".
Add new rake tasks for the new locations, while maintaining backwards
compatibility with the old rake tasks.

New testing locations are as follows:

    app/models -> test/models (was test/units)
    app/helpers -> test/helpers (was test/units/helpers)
    app/controllers -> test/controllers (was test/functional)
    app/mailers -> test/mailers (was test/functional)

This reverts commit d20281ad.

Reason: This needs more investigation. Will apply when this is verified.

see: https://github.com/blog/738-sidejack-prevention-phase-2-ssl-everywhere