the current version uses `@see` but moving this to the constructor confused the docs formatter and it made a complete hash of the text; inline `@link` is the better solution (unless, of course, formatting of `@see` were fixed)