1
0
mirror of https://github.com/BlizD/Tasks.git synced 2025-01-14 03:20:16 +02:00
Tasks/CONTRIBUTING.md
2017-10-01 18:55:37 +03:00

58 lines
5.9 KiB
Markdown

## Если Вы хотите доработать Tasks, не останавливайте свое желание, добро пожаловать в опенсорсную разработку :)
**Как доработать конфигурацию с помощью Github (подробное описание):**
**Прежде всего необходимо сделать следующее:**
1. Зарегистрироваться на https://github.com;
1. Установить 1с платформа 8.3.9.1850 - важно использовать именно эту платформу, т.к. версия платформы влияет на формат выгрузки на исходники из конфигурации;
1. Скачать и установить SourceTree - программа нужна для отправки коммитов на Github (или любую другую, но в примере будет рассказываться именно SourceTree);
1. Ссылка для скачивания https://www.sourcetreeapp.com
1. Скачать и установить GIT
1. Заходим на официальный сайт Git и скачиваем последнюю версию git для windows.
1. Официальный сайт Git http://git-scm.com/
1. При установке используем Далее - Далее
1. Пошаговая инструкция как установить GIT от rtnm https://bitbucket.org/rtnm/gittertutorial - необходимо смотреть раздел Установка Git
1. Перейти по ссылке https://github.com/BlizD/Tasks далее нажмите на кнопку Star - шучу,шучу :) этот пункт необязателен, можно идти дальше;
![image](https://user-images.githubusercontent.com/10989306/30324248-00bc2a6a-97c9-11e7-9349-13d8d08020be.png)
**Схема работы (как кодировать, как запускать Pull request и т.п.)**
1. Сделайте fork проекта с ветки "develope" - это означает нажать на кнопку **Fork** - при этом если откроете свой
профиль на Github, то увидите, что у вас появилась Ваша локальная копия репозитория Tasks (будет написано Forked from https://github.com/BlizD/Tasks);
1. В СоурсТри указать ссылку на Ваш форк
1. при этом указать папку куда будет скопирован репозиторий. Далее в эту же папку надо будет выгружать исходники из конфигуратора;
1. Загрузка исходников из форка
1. Кодирование по задаче
1. Выгрузка исходников в папку
1. Коммит из СоурсТри и отправка во внешний репозитарий
1. Создание ПуллРеквеста в исходный репозиторий - по сути это запрос, чтобы добавили Ваш код в исходный репозиторий
1. Если все ОК теперь Ваш код будет влит в основную ветку проекта
1. Поздравляем Вас с первым принятым ПуллРеквестом на GitHub. Теперь Вы участник всемирного опенсорсного сообщества.
**Что делать если мой Fork сильно отстал от исходного проекта**
1. Если Вы уже делали fork ранее и хотите получить обновление в свой fork из ветки "develope", тогда необходимо сделать следующее (если используется SourceTree):
* Меню - Репозитарий - Добавить внешний репозитарий;
* После этого жмем Получить выбираем внешний репозитарий;
**Как доработать конфигурацию с помощью Github (Краткое описание):**
1. Поискать задачу в списке задач (issues) проекта https://github.com/BlizD/Tasks/issues
1. Если нет уже существующей задачи, создайте новую, в которой опишите новые требования. В этой задаче можно будет обсудить как само требование, так и реализацию.
1. Возможно, Ваше требование уже реализовано или может быть реализован другим способом, отличным от придуманного Вами.
1. Использовать платформу 8.3.9.1850
1. Сделайте fork проекта с ветки "develope";
1. Если Вы уже делали fork ранее и хотите получить обновление в свой fork из ветки "develope", тогда необходимо сделать следующее (если используется SourceTree):
* Меню - Репозитарий - Добавить внешний репозитарий;
* После этого жмем Получить выбираем внешний репозитарий;
1. Получите свою локальную копию;
1. Выполняете задачу на своей локальной копии;
1. Далее сделайте pull-request в проект. https://github.com/BlizD/Tasks/pulls;
1. ВАЖНО: **выбирайте ветку `features`, а не `master` или `develope`**;
1. ВАЖНО: **убедитесь, что Ваш fork синхронизирован с оригинальным репозиторием** `develope`