All public API must be documented, and you'd also need to add `@since 1.5` so that users can easily tell when this was introduced.