Comment

Comment by verinus

I am still in the middle of reading the book and have not read the part about comments, but so far I have yet so see good comments in source code up to a point where I have a rather biased opinion on comments:

* good software needs hardly any comments: small methods with good naming facilitate readability

* unit tests are superb documentary as every dev can see how it is used and how it works at runtime.

* meaningful documentation is hardly ever provided in source code: purpose of abstraction layers and modules, how one class/module relates to another and so on (design and architecture).

parent verinus 5 years ago

Discussion

Live from the official Hacker News API

A modern reader for Hacker News · SvelteKit + Skeleton