Improve documentation

[orome]

• Write better usage messages.
• Add more complete comments in the code.
• Add descriptions to the demo notebook.
• Add some examples to the readme.
• Add more links to online resources (e.g. Oekaki sites)
• Add example of image solution (vs. QR code)
• Add to description of package and each function
• Improve variable names