dartdoc the `create` function