We piggyback on haddock wtr to which comments are documentation vs which are regular documentation. We don’t use haddock for parsing a doc comment or generating the resulting documentation.
There isn’t any great documentation for this at the moment. daml-docs is still in labs status. Looking through the daml-stdlib documentation is probably your best option for figuring out what is possible.