@deshipu@mastodon.technology @kensanata what percentage of maintainers read the developers' code comments, deliberately and placing trust in it? it is a small percentage in my experience. whereas code with useful symbol names would read a bit better and not need the crutches of likely stale comments.

Executable specs a.k.a tests are a more useful way to communicate intent. and you could go to town commenting the test code because there is no implementation detail to distract from them being read.