We very recently had a megathread on improving documentation; one of my main takeaways was the pointer to the fact that there isn’t a single thing called documentation; not only are the potential target audiences different, but there are four different kinds of formats needed for solid documentation:
The Julia manual is largely a reference, with some parts mixed up with explanation. There is definitely room for improvement in our documentation and onboarding references.
Suffice it to say that this is very well-trod ground in this discussion forum!