I’m currently documenting a project and noticed two things:
The improved scaladoc interface does not list package members any more in the values of a particular package.
With package objects being dropped in Dotty, the package object documentation comments do not have a place to go.
Finally, there is the weird inconsistency of having the root documentation in a text file pointed to by the
Right now, Scala does not prescribe a particular directory structure for source files; thus, we cannot prescribe that each package directory should contain a
scaladoc.txt text file (as in
I wonder what a solution could look like.