How to use Docblocks in Reason?

#1

What’s the recommended way to use docblocks in Reason? When doing it JSDoc style the bullets appear in the hover hints in VS Code, and I’ve seen some examples like

/***
 * Some comment
 */

But that doesn’t show up in hover hints at all.

#2

Documentation comments are delimited with /** and */.

I just tried it out, and discovered that VS Code even parses the contents as Markdown, for display, so this:

/**
 This is the first line. _Italicized_ word.

 * This is a bullet point.
 * This is the second point. */

becomes:

Screenshot