Better documentation

- Out of band endpoint is now called HTTP API
- A few diagrams in the readme
- Better readme structure