document `type` param.