Tasks/CONTRIBUTING.md

Если Вы хотите доработать Tasks, не останавливайте свое желание, добро пожаловать в опенсорсную разработку :)

Как доработать конфигурацию с помощью Github (подробное описание):

Прежде всего необходимо сделать следующее:

1. Зарегистрироваться на https://github.com;
2. Установить 1с платформа 8.3.9.1850 - важно использовать именно эту платформу, т.к. версия платформы влияет на формат выгрузки на исходники из конфигурации;
3. Скачать и установить SourceTree - программа нужна для отправки коммитов на Github (или любую другую, но в примере будет рассказываться именно SourceTree);
   1. Ссылка для скачивания https://www.sourcetreeapp.com
4. Скачать и установить GIT
   1. Заходим на официальный сайт Git и скачиваем последнюю версию git для windows.
      1. Официальный сайт Git http://git-scm.com/
   2. При установке используем Далее - Далее
      1. Пошаговая инструкция как установить GIT от rtnm https://bitbucket.org/rtnm/gittertutorial - необходимо смотреть раздел Установка Git
5. Перейти по ссылке https://github.com/BlizD/Tasks далее нажмите на кнопку Star - шучу,шучу :) этот пункт необязателен, можно идти дальше;

Схема работы (как кодировать, как запускать Pull request и т.п.)

1. Сделайте fork проекта с ветки "develope" - это означает нажать на кнопку Fork - при этом если откроете свой профиль на Github, то увидите, что у вас появилась Ваша локальная копия репозитория Tasks (будет написано Forked from https://github.com/BlizD/Tasks);
2. В СоурсТри указать ссылку на Ваш форк
   1. при этом указать папку куда будет скопирован репозиторий. Далее в эту же папку надо будет выгружать исходники из конфигуратора;
3. Загрузка исходников из форка
4. Кодирование по задаче
5. Выгрузка исходников в папку
6. Коммит из СоурсТри и отправка во внешний репозитарий
7. Создание ПуллРеквеста в исходный репозиторий - по сути это запрос, чтобы добавили Ваш код в исходный репозиторий
   1. Если все ОК теперь Ваш код будет влит в основную ветку проекта
8. Поздравляем Вас с первым принятым ПуллРеквестом на GitHub. Теперь Вы участник всемирного опенсорсного сообщества.

Что делать если мой Fork сильно отстал от исходного проекта

1. Если Вы уже делали fork ранее и хотите получить обновление в свой fork из ветки "develope", тогда необходимо сделать следующее (если используется SourceTree):
   • Меню - Репозитарий - Добавить внешний репозитарий;
   • После этого жмем Получить выбираем внешний репозитарий;

Как доработать конфигурацию с помощью Github (Краткое описание):

1. Поискать задачу в списке задач (issues) проекта https://github.com/BlizD/Tasks/issues
2. Если нет уже существующей задачи, создайте новую, в которой опишите новые требования. В этой задаче можно будет обсудить как само требование, так и реализацию.
   1. Возможно, Ваше требование уже реализовано или может быть реализован другим способом, отличным от придуманного Вами.
3. Использовать платформу 8.3.9.1850
4. Сделайте fork проекта с ветки "develope";
   1. Если Вы уже делали fork ранее и хотите получить обновление в свой fork из ветки "develope", тогда необходимо сделать следующее (если используется SourceTree):
   • Меню - Репозитарий - Добавить внешний репозитарий;
   • После этого жмем Получить выбираем внешний репозитарий;
5. Получите свою локальную копию;
6. Выполняете задачу на своей локальной копии;
7. Далее сделайте pull-request в проект. https://github.com/BlizD/Tasks/pulls;
   1. ВАЖНО: выбирайте ветку features, а не master или develope;
   2. ВАЖНО: убедитесь, что Ваш fork синхронизирован с оригинальным репозиторием develope