I would like to point out that I found the Julia manual helpful when I started using it.
But in truth some of the things made sense only a long way down the road, and
some I skipped, at least initially.
In my opinion the manual blurs together the four kinds of user documentation, with attendant reduction in efficiency. In other words, the four “boxes”
are visited in this single document with little or no separation.
I personally try to follow in my own packages
the view of the sw documentation outlined here:
https://documentation.divio.com/ (I have no stake in this effort.)
I am sure the separation of the present documentation into tutorials, how-to guides, explanations, and reference would be a non-trivial effort. But I for one am willing
to help. Writing parts of the documentation is a great opportunity for
Julia users to learn the language better, IMO.