Что такое Global Commenting?
Пишите минимальные полезные комментарии к коду, объясняющие почему, а не что, отдавая приоритет самодокументируемому коду с четкой структурой и именованием. Используйте этот навык при добавлении комментариев к коду, документировании сложной логики, объяснении неочевидных решений или алгоритмов, написании документации по функциям или классам, создании встроенных объяснений для больших разделов кода, удалении устаревших или бесполезных комментариев, рефакторинге кода, чтобы сделать его более понятным или обеспечении того, чтобы комментарии оставались актуальными и актуальными в долгосрочной перспективе. Используйте на всех языках программирования при принятии решения о том, следует ли комментировать код и если да, то как, в том числе при написании или просмотре файлов .js, .ts, .py, .java, .go, .rs, .rb, .php, .jsx, .tsx, .vue или любых других файлов кода. Источник: tlabs-xyz/tbtc-v2-performance.