Add documentation

[juan-foobar]

It would be great to have documentation for each function, what each one can do, limitations, use cases, examples, and misusage.

Based on comment from PR review.