improved documentation

[wwyaiykycnf]

documentation should include, at a minimum:

• description and use case (high level overview of intended usage)
• getting started (installing python, running a python script)
• first run
  • explain why it doens't work the first run
  • explain how to change config and add tags
• normal operation