Так вот вместо кучи лишних комментов достаточно писать нормальные названия переменных и нормальные методы типа includes а не ~~, мол экономия в пару символов
Я на самом деле не говорю что подход все описывать по 2 раза совершенно неверный, я просто предлагаю альтернативный более нормальный подход, где код сам себя документирует и читается почти 1 в 1 как предложение на английском