News for hackers. Stuff that matters.
Re:Unit Tests as Documentation by larsrc on Friday October 18, 2024 @02:28PM (#41882124)
"[docs] will take an example and do something with it to demonstrate an outcome."

No. Good docs will explain the context and choices made and trade-offs and risks and relations etc. All the things you can't read from the code. API docs can to a great degree be auto-generated, but not writing the _why_ is the beginning of the end.

There are no comments on this comment yet.