added doc comments, updated README