Documentation for using IntelliJ and Metals

[lrytz]

and two small fixes for the bsp export of the dotty project

[lrytz]

I personally think the bloop plugin should not be added to the build since not everyone is going to use it, so I would drop the last commit. I left it for discussion.

[sjrd]

I personally think the bloop plugin should not be added to the build since not everyone is going to use it, so I would drop the last commit. I left it for discussion.

We use the following beauty in Scala.js to set bloopGenerate without depending on sbt-bloop:
https://github.com/scala-js/scala-js/blob/46d094daa1576969fdd4948bf7a7571d9db1b156/project/NoIDEExport.scala

[adpi2]

Thanks @lrytz for pushing this! Now that we have Scala 3 support in Metals and IntelliJ, it's good to use them in the dotty repo.

I've made a few minor suggestions, but otherwise it LGTM.

[lrytz]

Thanks @adpi2, added your suggestions.

[lrytz]

@romanowski the bullet list is not rendered (https://dotty.epfl.ch/docs/usage/ide-support.html) - is that expected? Would be great if the rendering in scaladoc was the same as the preview on GitHub.

[romanowski]

It seems that this is a bug in Flexmark, empty line above is needed to render it properly. PR with fix is here: #11701

[lrytz]

Thanks! Worth a report at flexmark? I understand the situation about markdown standards and specifications is complicated, but...

https://github.com/vsch/flexmark-java#markdown-processor-emulation

flexmark is by default commonmark compliant

https://spec.commonmark.org/0.29/#example-273

no blank line is needed to separate a paragraph from a following list

[romanowski]

It needs a bit more investigation on our side to make sure that Felexmark is to blame, @BarkingBad should take a look soon