Официальный репозиторий проекта RusRails.ru

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

Установка и запуск

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

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

Создать конфиг для своих настроек бд (config/database.yml)
Заполнить базу
```
$ rake static_docs:import
```
Запустить сервер и открыть в браузере

Пул-реквесты

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

Нашли ошибку?

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

Нашли много ошибок?

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

Хотите помочь с переводами?

Для того, чтобы быстро и полно осуществлять переводы, каждое руководство привязано к определенной ревизии репозитория docrails.

Эта привязка осуществляется в файле https://github.com/morsbox/rusrails/blob/master/source/index.yml. Указывается заголовок на русском, имя файла в репозиториях docrails и rusrails, url на сайте rusrails, ревизия и дата коммита.

Таким образом, алгоритм работы:

клонируете репозиторий docrails (а лучше сделать форк) Инструкция по форкам
если уже есть репозиторий, обновляете его до актуального состояния (fetch/merge)
Делаете форк этого репозитория. Инструкция по форкам
Открываете issue, где говорите, какое руководство хотите обновить/перевести (чтобы этим руководством пока никто больше не занимался)
берете дифф по отдельному файлу git diff fa159d317611d1fe5b48 -- guides/source/getting_started.md >> gettin.diff. Ревизия - из файла source/index.yml
Смотрите номер последней ревизии по файлу git log -- guides/source/getting_started.md, изменяете эти данные в source/index.yml
Вносите в нужных местах исправления по диффу
Отправляете пул-реквест
Я принимаю изменения

Хотите помочь с развитием сайта?

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

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

Coolagin / rusrails