Русский перевод документации Laravel
Инструкция для желающих помочь с переводом:
- форкните репозиторий от 5.4-ru или другой ветки с пометкой -ru
- внесите любые минимальные изменения
- открой PR (из 5.4-ru своего форка в 5.4-ru TG) , в названии указав "[WIP] Название-раздела-который-планируете-переводить”
- в теле PR укажите список чекбоксов: по пунктам, что планируете переводить
- желательно в теле PR указать так же и оценку сроков
- начинайте переводить и коммитить, по ходу прогресса проставляя галочки в PR
- когда заявленный объём перевода выполнен, измените в заголовке [WIP] на [DONE] — это будет сигналом для мерджа
Об учёте изменений
На каждую из версий в репо существует две ветки: "оригинальная" (например, 5.4) и перевод (например, 5.4-ru). Для оценки того, что изменилось в оригинальной документации с момент начала перевода можно сделать PR из оригинального репо в "оригинальную" ветку данного — он покажет все изменения. Мерджить такие PR запрещено до момента отражения всех изменений в переводе. Такой подход позволяет не заниматься отслеживанием версий файлов по хэшам комитов, да и вообще он прост и надёжен. @gbezyuk
Contribution Guidelines
If you are submitting documentation for the current stable release, submit it to the corresponding branch. For example, documentation for Laravel 5.1 would be submitted to the 5.1 branch. Documentation intended for the next release of Laravel should be submitted to the master branch.