Рекомендую в чате рандомных анонимов не слушать конечно, но всё-таки обсудить эту задачу с участниками проекта, и выработать решение именно для "новым участникам не объяснять"
Комментарии в коде, тем более обязательные не выглядят как эффективное* решение такой задачи