adds some more documentation;
adds examples;