diff --git a/content/v1.0.0-beta.4/index.ru.md b/content/v1.0.0-beta.4/index.ru.md index 360fef9..6eda2ce 100644 --- a/content/v1.0.0-beta.4/index.ru.md +++ b/content/v1.0.0-beta.4/index.ru.md @@ -97,7 +97,7 @@ closes issue #12 1. Тип `feat` должен (MUST) использоваться, когда commit добавляет новый функционал (feature) в ваше приложение или библиотеку. 1. Тип `fix` должен (MUST) использоваться, когда commit исправляет ошибку (fix) -в вашем приложении или библиотеки. +в вашем приложении или библиотеке. 1. Контекст (scope) может (MAY) следовать после типа. Контекст должен (MUST) быть существительным, заключенным в круглые скобки, описывающий часть кодовой базы, которую затронул commit. Например, `fix(parser):`. @@ -106,11 +106,11 @@ closes issue #12 1. Тело (body) commit'а может (MAY) следовать после короткого описания, добавляя дополнительную информацию об изменениях в коде. Тело должно (MUST) отделяться от короткого описания одной пустой строкой. -1. Подвал (footer) может (MAY) быть представлен одной или более строкой после тела commit'а. +1. Подвал (footer) может (MAY) быть представлен одной или несколькими строками после тела commit'а. Он должен быть отделен от тела commit'а одной пустой строкой. Подвал должен (MUST) содержать мета-информацию о commit'е. Например, связанные pull-request'ы, обсуждения, изменения, нарушающие обратную совместимость. По одной мета-информации на строку. -1. Изменения, нарушающие обратную совместимость (breaking changes) должны (MUST) быть +1. Изменения, нарушающие обратную совместимость (breaking changes), должны (MUST) быть указаны в самом начале тела (body) или в начале одной из строк подвала (footer). Изменения, нарушающие обратную совместимость, должны (MUST) начинаться с текста, написанного прописными буквами, BREAKING CHANGE, за которым должны следовать двоеточие и пробел. @@ -129,7 +129,7 @@ _BREAKING CHANGE: environment variables now take precedence over config files._ * Автоматически генерируемый CHANGELOGs. * Автоматическое определение семантической версии SemVer (на основе типов совершенных commit'ов). -* Коммуникация о характере изменения между товарищами по команде, общественностью и другими заинтересованными сторонами. +* Коммуникация о характере изменений между товарищами по команде, общественностью и другими заинтересованными сторонами. * Автоматически срабатываемый процесс сборки и публикации. * Людям проще участвовать в вашем проекте, потому что им доступна более структурированная история коммитов. @@ -157,12 +157,12 @@ _BREAKING CHANGE: environment variables now take precedence over config files._ ### Могут ли Conventional Commits заставить разработчиков ограничивать их типы commit'ов, потому что им придется думать об этих типах? Conventional Commits побуждают делать больше commit'ов с определенными типами, такими как `fix`. Кроме того, гибкость -Conventional Commits позволяют вашей команде создавать свои собственные типы и изменять их с течением времени. +Conventional Commits позволяет вашей команде создавать свои собственные типы и изменять их с течением времени. -### Как она связывается с правилами семантического управления версиями [SemVer](http://semver.org)? +### Как это связано с правилами семантического управления версиями [SemVer](http://semver.org)? `fix` тип commit'а должен быть отражен в `PATCH`-релизе. `feat` тип commit'а должен быть отражен в `MINOR`-релизе. -Commit'ы с `BREAKING CHANGE` в теле или подвале, не зависимо от типа, должны быть отражены в `MAJOR`-релизе. +Commit'ы с `BREAKING CHANGE` в теле или подвале, независимо от типа, должны быть отражены в `MAJOR`-релизе. ### Как я должен версионировать мои расширения к спецификации Conventional Commits, например, `@jameswomack/conventional-commit-spec`? @@ -181,14 +181,14 @@ Commit'ы с `BREAKING CHANGE` в теле или подвале, не зави ### Должны ли все мои соавторы использовать спецификацию Conventional Commit? -Нет! Если ваш рабочий процесс основа на использовании слияния (squash) Git, сопровождающий проекта может отчистить -историю всех предыдущих commit'ов при их слияния, не добавляя рабочей нагрузки на случайные commit'ы. Обычно, -рабочий процесс строится на том, что ваша система Git автоматически объединяет (squash) все предыдущие commit'ы пред +Нет! Если ваш рабочий процесс основан на использовании слияния (squash) Git, сопровождающий проекта может очистить +историю всех предыдущих commit'ов при их слиянии, не добавляя рабочей нагрузки на случайные commit'ы. Обычно, +рабочий процесс строится на том, что ваша система Git автоматически объединяет (squash) все предыдущие commit'ы перед pull-запросом и предоставляет форму сопровождающему проекта для ввода нового commit'а. ## О спецификации -Conventional Commit вдохновлены и основаны на +Conventional Commits вдохновлены и основаны на [Angular Commit Guidelines](https://github.com/angular/angular/blob/22b96b9/CONTRIBUTING.md#-commit-message-guidelines). Первый черновик спецификации был написан в сотрудничестве с некоторыми участниками: @@ -198,14 +198,14 @@ Conventional Commit вдохновлены и основаны на * [bumped](https://bumped.github.io): утилита для релиза приложений, которая позволяет легко выполнять действия до и после релиза новой версии ваших приложений. * [unleash](https://github.com/netflix/unleash): утилита для автоматического релиза и публикации приложений. -* [lerna](https://github.com/lerna/lerna): утилита для управления моно-репозиториями, которая выросла и проекта Babel. +* [lerna](https://github.com/lerna/lerna): утилита для управления моно-репозиториями, которая выросла из проекта Babel. ## Утилиты для Conventional Commits -* [php-commitizen](https://github.com/damianopetrungaro/php-commitizen): утилита для создания сообщений commit'ов, следующих Conventional Commit спецификации. +* [php-commitizen](https://github.com/damianopetrungaro/php-commitizen): утилита для создания сообщений commit'ов, следующих Conventional Commits спецификации. Используется для PHP-проектов, как зависимость composer, или глобально для не PHP-проектов. * [conform](https://github.com/autonomy/conform): утилита, которая может быть использована для реализации политик в git-репозиториях, включая правила написания commit'ов. -* [standard-version](https://github.com/conventional-changelog/standard-version): утилита, для автоматический контроля версий и CHANGELOG'ов, +* [standard-version](https://github.com/conventional-changelog/standard-version): утилита, для автоматического контроля версий и CHANGELOG'ов, использующая новую кнопку `Squash` GitHub'а. Рекомендует использовать Conventional Commits в рабочем процессе. ## Проекты, использующие Conventional Commits