Update README and add doc-comments