Looking through the sources julia/stdlib at v1.7.0-rc1 · JuliaLang/julia · GitHub and comparing to the corresponding documentation, it’s unclear which modules seem to be stdlibs or not. As an example,
Tar is an stdlib (seemingly added in 1.6?), has a NEWS.md entry for 1.7 but not for 1.6 (and NEWS.md for 1.6 makes no mention of it), yet the documentation can only be found in the upstream repo itself. Similar problems exist with
NetworkOptions. Does that mean these are less of an stdlib than other packages, e.g. Distributed? I think all of these were added in 1.6 (at least NetworkOptions and Downloads were, according to this blog post, but only
Downloads seems to have managed to get documentation that shows up in docs.julialang.org. To someone who doesn’t know about the blog posts above, these stdlibs may as well not exist, since they’re not discoverable at all without someone telling them that they exist.
What constitutes an stdlib? What quality requirements do we have for an stdlib? What quality requirements do we have for the documentation of an stdlib? What’s the process for deciding what gets documented (do we have one…?)? How can we do better here? Can we maybe look to other projects for inspiration (the very extensive documentation of rust comes to mind)?