Drop .cacheable documentation

Some small changes to the docs:

* Drop cacheable documentation. Defer to `.volatile`.
* Drop the last lingering used of `.cacheable` in a test.
* Drop the `/**` preamble for controller generator documentation. Quiets a warning.

Tom Dale sez "confirm, we should document volatile()" which I presume means not document cacheable.

:cake: