News for hackers. Stuff that matters.
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.

[1] https://documentation.divio.com/

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/

Re:Why Turtl switched from Common Lisp to JavaScript (2019) by math-dev on Thursday October 28, 2021 @06:07AM (#29024217)
Thanks, will check it out!
Re:Why Turtl switched from Common Lisp to JavaScript (2019) by math-dev on Thursday October 28, 2021 @06:06AM (#29024209)
Agree 100%