add REVIEW comments, add some missing JSdoc