News for hackers. Stuff that matters.
Re:Selfish Writing by ivan_ah on Friday December 16, 2022 @01:41PM (#34018363)
Agreed. I'm currently working on a book on statistics[1] and keep discovering slight (and not so slight) misconceptions in my thinking thanks to the "optional" code examples and demonstrations. In the end, it seems the code examples won't be optional at all, but essential for understanding.

It's the same with many science and tech subjects. You don't really know it until you can code it. I'm intentionally converting some of the derivations/experiments into exercises for readers to complete on their own, so they can also benefit from this learning process.

[1] https://nobsstats.com/

Re:Selfish Writing by karencarits on Friday December 16, 2022 @03:54PM (#34020230)
I fully agree with you, but as a warning: most people are lazy, so if valuable points are hidden in exercises for the reader, there is a significant chance that many will miss them
Re:Selfish Writing by stevenally on Friday December 16, 2022 @06:04PM (#34021824)
A software project is a voyage of discovery.