Avoid compiling the build during mdoc.properties resource generation (take 2)

[matthughes]

Reviving #174 as I don't really understand why it was closed nor why bloopInstall has to trigger the creation of mdoc.properties.

Seems like @olafurpg thought this was not a problem with a change to Bloop but it happens with my build. I incrementally change my build, doing a clean, bloopInstall as I add each project to see which one is triggering the compilation. As soon as I add my docs project, bloopInstall triggers the entire build.

What's kind of weird is the docs bloop config files get written out, then the project triggers compilation.

[matthughes]

My guess is it's this setting that triggers things?

https://github.com/scalameta/mdoc/blob/main/mdoc-sbt/src/main/scala/mdoc/MdocPlugin.scala#L118

[tgodzik]

It probably is, we actually talked with @olafurpg about resource generation and it should not be part of the build import. He was also advocating for much less BSP being involved altogether, but I am not yet convinced.

I think we could remove resource generation from bloopInstall step and rely on the user to create that?

Just to make sure, it's only happening with Bloop?

[matthughes]

"only with Bloop" vs what? Using SBT? I have not tried that path.

Does resourceGeneration include generated source? I mean, as long as the directories are in the bloop config file, I don't see why we need the resources generated.

[tgodzik]

Only in sbt with Bloop plugin is what I meant.

[matthughes]

Right which includes when importing the project in Vscode as that just kicks off the bloopInstall.

…

On Fri, Jan 30, 2026 at 12:53 PM Tomasz Godzik ***@***.***> wrote: *tgodzik* left a comment (scalameta/mdoc#1063) <#1063 (comment)> Only in sbt with Bloop plugin is what I meant. — Reply to this email directly, view it on GitHub <#1063 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AABKITALLFOYP7N3VE5KXE34JOLDLAVCNFSM6AAAAACTOFCB52VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTQMRUHEZTKNRTGQ> . You are receiving this because you authored the thread.Message ID: ***@***.***>

[olafurpg]

Bloop needs resources to be generated to support testing with full fidelity. However, Metals doesn't need the resources. You can try disabling the Bloop plugin on the docs project.

[olafurpg]

Bloop needs resources to be generated to support testing with full fidelity. However, Metals doesn't need the resources. You can try disabling the Bloop plugin on the docs project.

[tgodzik]

Och yeah, you can actually set bspEnabled := false and that can help. We can set that as default for docs project 🤔