Just a minor comment tweak

Documenting where to add titles to figures in the gallery should we choose to
do that.
Merge pull request #2174 from dmcdougall/comment_tweak

Just a minor comment tweak