This is for developer documentation, so it should mention that `ref` is optional.