update resource md and comments