Fix a few comments

more to come before the beta (ideally all comments should have been update, not the doc but at least the comments)