Каждый кусок кода в Гугле должен быть проверен человеком, который понимает, в чём логика этого куска кода и человеком, который понимает, как хорошо писать на этом языке программирования (это может быть один и тот же человек).
"Понимать, как хорошо писать на этом языке программирования" называется "have *language* readability" и имеет более-менее чёткие критерии.
Я сейчас пытаюсь получить Dart readability. Это означает, что каждый свой кусок кода я, помимо предыдущих проверок, ещё отсылаю людям, которые проверяют, что я достаточно хорошо умею писать на дарте (причем эти люди назначаются автоматически и обычно не имеют никакого отношения к моей команде).
Так вот, вчера мой код попал к человеку, который, скажем так, вместо проверки кода занялся удовлетворением своего ЧСВ. Настолько, что когда я получила его комментарии, мне захотелось только послать его подальше. Поэтому отложила до утра.
Утром обнаружилось, что помимо рассказов о том, как я плохо пишу код, там всё-таки есть пара разумных комментариев.
Так к чему я всё это пишу? К тому, что у меня прекрасные сокомандники! Когда я спросила их о разумной части (спасибо английскому языку, что то, что мне не нравится стиль этих комментариев, можно выразить мимоходом и очень вежливо), они не только рассказали мне, как сделать хорошо, но и пришли в комментарии меня защищать!
Очень приятно, что повезло с командой :)
Post #548
3.76K