Documentation

[jpittis]

All public interfaces should be documented. We should also add some high level explanations and diagrams. Maybe a quick start example.