Improve GFM code documentation

Administratorrequested to merge
github/fork/riyad/improve-gfm-code-docs into master

Created by: riyad

addresses questions that came up in #1232

Merge request reports