sedovalx / taxi

Общая информация

Структура репозитория

• docs - документы по проекту
• sources/server - исходные кода сервера, открываются в IntelliJ IDEA
• sources/client - исходные коды клиента, открываются в WebStorm

Ссылки для изучения

• Беглое ознакомление с Scala от Twitter
• Курс по функциональному программированию на Scala
• Курс по реактивному программированию на Scala
• Scala Core
• Scala Tutorial
• Play!
• Slick
• Ember.js
• Ember-cli
• Handlebars
• Bower
• Twitter bootstrap
• JavaScript
• HTML & CSS

Работа с Git из IntelliJ IDEA

• Установить Git
• В IDEA нужно настроить использование Git. Идем в Settings -> Version control -> Git. Убеждаемся, что там указан верный путь на исполняемый файл Git'а. Можно проверить, нажав кнопку Test.
• Если еще не зарегистрированы на GitHub, то регистрируемся.
• В IDEA нужно указать логин и пароль для GitHub, чтобы не вводить их каждый раз. Для этого идем в Settings -> Version Control -> GitHub.
• Клонируем репозиторий из GitHub. Для этого идем в меню VCS -> Checkout from version control -> GitHub, указываем адрес репозитория, родительский каталог, в котором создастся локальный репозиторий, и имя каталога с репозиторием.

Взять последние изменения из главного репозитория

Перед коммитом своих правок нужно забрать последние изменения из главного репозитория и убедиться локально, что ваши изменения ничего не поломают. Обычно для этого достаточно сделать билд клиента и сервера.

• VCS -> Update Project (Ctrl+T), OK.

Сделать коммит изменений

Коммит подразумевает запись изменения в свой локальный репозиторий, который является клоном центрального репозитория на GitHub. Локальный репозиторий располагается в каталоге .git, из него всегда можно заново восстановить весь проект в состоянии последнего (или любого из предыдущих) коммита. Т.е. удалять каталог .git не нужно. Во время коммита отправка изменений в центральный репозиторий не происходит.

• View -> Tool Windows -> Changes
• Смотрим, какие файлы были изменены вами. Некоторый можно добавить в игнор-лист, чтобы они никогда не попадали в репозиторий. Если увидите в списке секцию Unversioned files, то файлы из нее нужно будет либо добавить под контроль версий, либо удалить с диска, либо добавить в игнор-лист. Файлы, добавленные под контроль версий, попадут в коммит.
• Когда готовы, жмем Commit changes
• В появившемся окне ставим галочки напротив тех файлов, которые хотим закоммитеть и пишем комментарий, поясняющий, что мы наменяли.
• Жмем Commit. Можно сразу нажать Commit and Push, тогда при этом помимо коммита в локальный репозиторий произойдет попытка записи в главный репозиторий.

Залить локальные изменения в главный репозиторий

Если локально накопилось достаточно изменений, все работает, и вы готовы этим поделиться, то делаем запись в GitHub-репозиторий.

• VCS -> Git -> Push (Ctrl + Shift + K)
• Убедимся, что есть комментарий и жмем Push

Создание pull request

Процесс Push'а может упасть, если у вас нет прав на запись в глобальный репозиторий. Тогда создаем pull request, который получит хозяин репозитория, посмотрит ваши изменения и, если все ок, зальет в центральный репозиторий. Свои заявки на изменения и их состояние можно увидеть по адресу https://github.com/sedovalx/taxi/pulls

• VCS -> Git -> Create pull request
• Убеждаемся, что есть комментарий, и жмем ОК.