add docblocks to all files, classes, methods and variables
update README