11.2K ·GitHub
Что это такое?
Тщательно подобранный список руководств по стилю программирования, лучших практик и соглашений по оформлению кода — одна страница со ссылками на официальные и общественные рекомендации для десятков языков, платформ и инструментов.
Это инструмент, который нужно устанавливать, или просто что-то, что я читаю?
Просто справочник для чтения: один README с аннотированными ссылками в формате awesome-списка. Устанавливать и запускать ничего не нужно — открываете, находите свой язык или платформу и переходите к руководствам.
Как устроен список и как найти руководства для своего стека?
README разбит на разделы: Programming Languages (языки программирования), Development Environment (среда разработки), Platforms (платформы), Frameworks (фреймворки), CMS и Tools (инструменты). Перейдите к своему языку — например, для Python там приведена ссылка на официальное руководство по стилю PEP 8 — и выберите соглашения, которым хотите следовать.
Какие языки программирования он охватывает?
Более 40 разделов: от популярных языков вроде C++, Java, JavaScript, Python, Go, Rust и Swift до нишевых вроде Brainfuck, Nim, Fortran и Delphi, плюс форматы вроде JSON, Markdown и XML.
Есть ли там руководства по стилю от крупных компаний?
Да — руководства Google, Airbnb, Uber, Mozilla, LLVM, NASA, LinkedIn, Databricks и Alibaba соседствуют с общественными проектами вроде Ruby Style Guide и официальной документацией вроде Effective Go и PEP 8.
Есть ли что-то про безопасность?
Да — в списке есть .NET Secure Coding Guidelines, руководства по безопасной разработке для Erlang, API Security Checklist и стандарт Solcurity для смарт-контрактов на Solidity.
Как список остаётся аккуратным — проверяют ли записи?
В репозитории awesome-lint запускается в CI, чтобы форматирование списка оставалось единообразным, а отдельный stale-воркфлоу помечает неактивные issues и pull request'ы. Отдельные ссылки со временем всё же могут устареть.
What are similar projects?
every-programmer-should-know, awesome-modern-cpp, awesome-awesomeness, golang-developer-roadmap, guide, rust-learning, eng-practices, hacker-laws
Which topics is it in?
guidelines, style-guide, software-engineering, code-quality, best-practices, computer-science, programming, awesome, reference, guide, learning-resources, developers