add some missing doc comments
update readme