even more documentation and examples