adds initial documentation
and some examples