renamed tests folder, otherwise confusing
adding usage examples in doc

Still needs to work better out examples that work well out of the box