update many code comments and generate docs
update many code comments and generate docs