Finalize documentation

[rec]

• Add many examples
• Add warning section
• Proof on both pypi and github

Write the documentation in the README.

Then read that and bring it into the HELP file.