そんなこと言われなくてもわかってるよ、とみんなが思っているようなことを
いちいちコードに含めるのはナンセンスだよね。
一見さんには辛いかもしれないけど、そういう人たちのための補助的な情報は
コードにではなく書籍とかウェブとかに載せておけばいい。
コードには初心者にも上級者にも必要な本質だけが載っているべきだと僕は思うよ