DOC: Improve figures references and caption

The figures were not referenced correctly. We activate
the numfig parameter so that figures can be references to
by their number. We also add captions to the figures.
25 jobs for !735 with doc_monteverdi in 72 minutes and 53 seconds (queued for 6 seconds)
merge request