document `params` and `resource`