News for hackers. Stuff that matters.

A comment on Book Review: A Philosophy of Software Design (2020). Parent comment

Re:Book Review: A Philosophy of Software Design (2020) by godshatter on Wednesday June 30, 2021 @04:07PM (#27692890)
> * unit tests are superb documentary as every dev can see how it is used and how it works at runtime

Unit tests tell me how the code is supposed to behave given certain inputs, but without a statement of what the function is trying to accomplish I can't tell if any necessary unit tests are missing. Or if any are just accidentally working.

[ Parent | on HN ]
Re:Book Review: A Philosophy of Software Design (2020) by verinus on Thursday July 01, 2021 @02:15AM (#27696731)
true.

But (hopefully) most of the time good naming, parameters and return types and the context of the library does that.

But you are right, esp. complex methods or APIs require lots of documentation- but tbh I doubt it is in sources...

[ Parent | on HN ]