Проект RusRails является неофициальным переводом официальных руководств по Ruby on Rails

• Скопировать и установить

  $ git clone git://github.com/rusrails/rusrails.git
  $ cd rusrails
  $ bundle install
  

• Создать конфиг для своих настроек бд (config/database.yml)

• Создать базу данных и загрузить схему базы данных

   rails db:setup
  

• Заполнить базу

  $ rails static_docs:import
  

• Запустить сервер и открыть в браузере

Все пул-реквесты нужно делать в ту ветку, которая выставлена в данный момент текущей на гитхабе!

• Находите нужный файл в source (соответствие url на сайте rusrails и имени файла задается в source/index.yml)
• В интерфейсе есть кнопка Edit
• Вносите изменение
• Commit / Push

• Делаете форк. Инструкция по форкам
• У себя в репозитории правите ошибки (желательно для каждого руководства править ошибки в отдельных ветках)
• Отправляете пул-реквест

Для удобного перевода, каждое руководство привязано к определенной ревизии rails/rails, в файле source/index.yml. Таким образом, указывается заголовок на русском, url, имя файла, ревизия и дата коммита.

Алгоритм работы:

• Делаете форк. Инструкция по форкам
• Выбираете руководство (степень актуальности всех руководств можно оценить с помощью rails docrails:status)
• Открываете issue в rusrails, с пометкой о руководстве которое хотите обновить/перевести (чтобы этим руководством никто параллельно не занимался)
• Смотрите, что изменилось - rails 'docrails:diff[file_name]' > diff.diff - в файле diff.diff
• В том же файле смотрите информацию по последней ревизии и ее дате, изменяете эти данные в source/index.yml
• Вносите в нужных местах исправления по диффу
• Отправляете пул-реквест

Есть много всяких идей, до которых руки не доходят, например, правки дизайна, социализация, расширение на другие руководства, связанные с Rails, версии в PDF/kindle и т.д.

Предлагайте свои идеи, которые в состоянии реализовать. @RusRails

HTML версия развертывается на Github Pages.

Предполагается, что клон репозитория rusrails/rusrails.github.io находится в той же директории, что и клон rusrails/rusrails.

Тогда rails deploy:start сгенерирует свежую версию и отправит на Гитхаб.