![Gitter](https://badges.gitter.im/Join Chat.svg) Официальный репозиторий проекта 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 / Push
- Делаете форк. Инструкция по форкам
- У себя в репозитории правите ошибки (желательно для каждого руководства править ошибки в отдельных ветках)
- Отправляете пул-реквест
Для удобного перевода, каждое руководство привязано к определенной ревизии rails/docrails, в файле source/index.yml. Таким образом, указывается заголовок на русском, имя файла, url, ревизия и дата коммита.
Алгоритм работы:
- Клонируете репозиторий docrails, если уже есть репозиторий, обновляете его до актуального состояния (fetch/merge)
- Открываете issue в rusrails, с пометкой о руководстве которое хотите обновить/перевести(чтобы этим руководством никто параллельно не занимался)
- Берете diff по отдельному файлу
git diff fa159d317611d1fe5b48 -- guides/source/getting_started.md >> getting.diff
. Ревизия - из файлаsource/index.yml
- Смотрите номер последней ревизии по файлу
git log -- guides/source/getting_started.md
, изменяете эти данные вsource/index.yml
- Вносите в нужных местах исправления по диффу
- Отправляете пул-реквест
Есть много всяких идей, до которых руки не доходят, например, редизайн, социализация, расширение на другие руководства, связанные с rails, и т.д.
Предлагайте свои идеи, которые в состоянии реализовать. @RusRails