Write section on nbsphinx galleries

[sbcowan]

Nbsphinx often has some buggy behaviour. It should be documented how to use nbsphinx galleries and what the best practice is.