Updates from the field

This builds on @arrbee's C parser PR and makes it used rugged, let's bundler work on it and parses the comments as markdown.

There are also a few accrued fixes that people have pointed out from the docs.

This is what currently generates the libgit2 documentation.