add more comments, change github annotation