- форкните репозиторий от 5.4-ru или другой ветки с пометкой -ru
- внесите любые минимальные изменения
- откройте PR (из 5.4-ru своего форка в 5.4-ru TG) , в названии указав "[WIP] Название-раздела-который-планируете-переводить”
- в теле PR укажите список чекбоксов: по пунктам, что планируете переводить и оценку сроков (см. пример)
- начинайте переводить и коммитить, по ходу прогресса проставляя галочки в PR
- когда заявленный объём перевода выполнен, измените в заголовке [WIP] на [DONE] — это будет сигналом для мерджа
- испытайте радость и приход от завершённой работы и внесённого вклада
На каждую из версий в репо существует две ветки: "оригинальная" (например, 5.4) и перевод (например, 5.4-ru). Для оценки того, что изменилось в оригинальной документации с момент начала перевода можно сделать PR из оригинального репо в "оригинальную" ветку данного — он покажет все изменения. Мерджить такие PR запрещено до момента отражения всех изменений в переводе. Такой подход позволяет не заниматься отслеживанием версий файлов по хэшам комитов, да и вообще он прост и надёжен. @gbezyuk
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.