Improve web build documentation

com-lihaoyi / mill

Mill is a fast JVM build tool that supports Java and Scala. 2-3x faster than Gradle and 5-10x faster than Maven for common workflows, Mill aims to make your project’s build process performant, maintainable, and flexible

https://mill-build.org/

MIT License

2.04k stars 331 forks source link

Improve web build documentation #3249

Closed arturaz closed 2 months ago

lihaoyi commented 2 months ago

Probably going to call this a wontfix. We can't really afford to duplicate all the minutae of the class hierarchy and task graph in the docs. Anyone who wants to see what it does can jump to definition in IntelliJ. Verbosity is its own cost, and I don't think this addition justifies the verbosity it adds

arturaz commented 2 months ago

The problem is that docs do not state that this trait is only available in certain scope, which is super confusing when you get a compilation error.

arturaz commented 2 months ago

And you can't jump to definition because the symbol is unresolved.