updated comments
version 1 of documentation with docco