Thanks all.
First, I will say my current project isn’t really optimized for multiple dispatch (ie, reusability). Maybe there is a tradeoff vs performance or code-readability there, but I can definitely see a benefit even for my own potential similar future projects.
Second, what about docs for non-exported functions? From looking at julia packages I see it is common for those to have little/no documentation.
Wouldn’t it be better if those had some kind of auto-docstring, then the developer would only need to fill in the placeholder text? The default now is to just let the code speak for itself.
Seems like a “don’t let perfect be the enemy of good” situation.
Edit:
A third point is the expected primary audience for my code is c++, etc devs with no familiarity with julia. So it seems useful to document everything.