I would use `/** ... */` and make use of `{@link ...}` and HTML tags.