a little more documentation
not ready for index.js yet