Over the past couple weeks I have made some major progress in documenting the Nixpkgs standard library functions. It is slow work, but thus far I’ve added web-facing documentation for over 25 functions. I’m working on roughly one each day. In addition to adding these to the public docs, each documented function has a link to where its source can be found on GitHub. I encourage you to check out my progress: https://nixos.org/nixpkgs/manual/#sec-functions-library
However, this post is really more of a request for feedback. I found a fairly simple way to automatically test the docs too! It only took 50 lines of python to make a demo, and a bit over 100 lines to make a nice UX for the tool. Check it out over on my PR https://github.com/NixOS/nixpkgs/pull/48497
What do you think? Are these docs satisfying the need for a reference manual? Are these doc tests valuable?