Clarify site.html_pages over on  http://jekyllrb.com/docs/frontmatter/

RE:
https://github.com/jekyll/jekyll/issues/2066#issuecomment-42780831

I think there might be some comments that need to be resolved.