Document gradient construction

[noelwelsh]

We have examples of using gradients in the docs, but we don't actually document gradients. Add:

• ScalaDoc for gradients
• Some mention in the docs on gradient construction

[noelwelsh]

Until #190 is complete the documentation cannot be adequately done, as the API is not up to the job.