Add authentication docs

Created by: odlp

Includes examples for Clearance, Devise and HTTP basic auth.

Also tidies up references to the old docs app which redirects to the prototype.