Docs issues

[hroncok]

• [ ] You have two READMEs
• [ ] When following the instructions about how to build the docs, I end up with:

reading sources... [100%] installation                                                                                                                                                                                             
/home/churchyard/tmp/mipyt/nzt4567/doc/source/api.rst:3: WARNING: autodoc: failed to import module 'gh_issue_agent'; the following exception was raised:
Traceback (most recent call last):
  File ".../env/lib64/python3.5/site-packages/sphinx/ext/autodoc.py", line 519, in import_object
    __import__(self.modname)
  File ".../gh_issue_agent/__init__.py", line 1, in <module>
    from .agent import parse_args, web_main, console_main, app, main, hook, index, console, web, cli, parse_file, \
  File ".../gh_issue_agent/agent.py", line 1, in <module>
    import requests
ImportError: No module named 'requests'

• [ ] No proper section with examples, just an artificial section with one doctest that is not understandable
• [ ] No doctest on Travis