add helpful comments

This is ready for the public to use