added a few comments and a documentation file