Re:Why Turtl switched from Common Lisp to JavaScript (2019)
by throw10920 on Wednesday October 27, 2021 @03:23PM
(#29017851)
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.
Re:Why Turtl switched from Common Lisp to JavaScript (2019)
by svetlyak40wt on Wednesday October 27, 2021 @07:07PM
(#29020149)
That 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/
Documentation in CL is pretty bad. Worst is when people say its well documented and its nothing but, all those manuals just listing all the functions are a complete nightmare and useless to me