• собранная версия учебника лежит на gh-pages;
• публикация происходит автоматически из master-ветки;
• собирается с помощью Jekyll;
• все разделы учебника лежат в папке guide.

1. Убедитесь, что у вас стоят Ruby, RubyGems и выполнены все остальные условия.

2. Установите Jekyll и Bundler с помощью RubyGems

$ gem install jekyll bundler

3. Если у вас официальная инструкция не работает из-за отсутствия доступа к Ruby, находящимся в системном разделе, то можно воспользоваться вот такой:

• убедитесь, что установлен xcode

$ sudo xcode-select --install

• установите rbenv с помощью Homebrew

$ brew install rbenv

• в зависимости от того, какой консолью пользуетесь, добавьте в конец файла ~/.zshrc или ~/.bash_profile строку

"$(rbenv init -)"

> узнать, какая консоль используется у вас, можно с помощью команды `$ echo $SHELL`

> для показа всех, даже скрытых и системных, файлов можно воспользоваться командой `ls -a`

• установите Ruby с указанием нужной/стабильной версии, например

rbenv install 2.3.0

• с помощью rbenv выберите установленную версию Ruby

rbenv global 2.3.0

• в новом окне терминала проверьте, что команда

gem env home

возвращает путь к пользовательской папке, а не системной

• установите Jekyll и Bundler с помощью RubyGems

$ gem install jekyll bundler

4. Запустите сборку и сервер из папки проекта

$ bundle exec jekyll serve

• Сделайте форк репозитория
• Внесите изменения (можно вносить много и долго)
• Когда будете готовы, создайте из вашего форка пулреквест и опишите, что вы сделали
• Дождитесь обсуждения ваших изменений и приёма их в мастер