Improve GFM code documentation

Created by: riyad

addresses questions that came up in #1232

合并请求报告