2 ms·
I'm guilty of this too! Change begins with one's self, they say, heh. (I should learn to write good docs before castigating the community) And you're right - t
by throw10920 5y ago
I'm guilty of this too! Change begins with one's self, they say, heh. (I should learn to write good docs before castigating the community)
And you're right - trivial docstrings for all the functions isn't documentation at all. Real documentation is the four-part system[1] of tutorials, howtos, examples, and reference material - I've found this mental framework to be enormously helpful for both (a) identifying when some other documentation is inadequate and (b) improving my own.
[1] https://documentation.divio.com/ https://documentation.divio.com/
- svetlyak40wt 5y agoThat is why I've put about half of this year into the Common Lisp documentation generator for all of my libraries. If you are interested, please read it's docs and join the effort of making good documentation for CL projects: https://40ants.com/doc/ https://40ants.com/doc/
- math-dev 5y agoThanks, will check it out!
- math-dev 5y agoAgree 100%