Automatically tested code examples in the documentation

[MargaretDuff]

We want to avoid untested and unmaintained code examples in the documentation. These should be moved to separate files, run automatically (and tested) and inserted in the documentation correctly.

For example:

• #1751 The call back example
• #1550 the SGD example