more documentation
more clarity