Documentation improvements
Documentation improvements

Separate documentation for generic agithub use and GitHub client specific use
Change generic examples to functional code that runs
Create new "Specific REST APIs" section
Fix malformed markdown
Add extensibility example
Pull details about headers and body parameters out of semantics section into dedicated parameters section

jpaugh/agithub,mozilla/agithub