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

Example headers are discouraged in the API guidelines.
Code just flows with the text. They may be good in
places where there's a lot of stuff and structure may
add clarity

Please excuse the revert. Albeit the commit is totally
innocent, docrails has a strong no-code policy we need
to enforce. Please feel free to submit the fix as a
patch and assign it to me, I'll apply right away.

This reverts commit d8462510.

as different ruby implementations may have different values,
for example Rubinius returns 53 for nil.id.

[#6444 state:resolved]

- cookies can be set using string or symbol keys
- cookies are preserved across calls to get, post, etc.
- cookie names and values are escaped
- cookies can be cleared using @request.cookies.clear

[#6272 state:resolved]

This reverts commit 1d482693.

Signed-off-by: NAndrew White <andyw@pixeltrix.co.uk>

Signed-off-by: NAndrew White <andyw@pixeltrix.co.uk>

* simplifies some sentences
* use a more neutral language with less you/yours