From a3ea00a352f29eab26dbf9835c74ff4ea9d988b4 Mon Sep 17 00:00:00 2001 From: Anton Ivanov Date: Sun, 1 Oct 2017 18:55:37 +0300 Subject: [PATCH] =?UTF-8?q?=D0=98=D0=B7=D0=BC=D0=B5=D0=BD=D0=B8=D0=BB=20?= =?UTF-8?q?=D1=84=D0=B0=D0=B9=D0=BB=20CONTRIBUTING?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CONTRIBUTING.md | 46 +++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 43 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0bd6ab1dc..67031c16f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,44 @@ -## Если вы хотите доработать Tasks, добро пожаловать :) +## Если Вы хотите доработать 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. Если нет уже существующей задачи, создайте новую, в которой опишите новые требования. В этой задаче можно будет обсудить как само требование, так и реализацию. @@ -14,4 +52,6 @@ 1. Выполняете задачу на своей локальной копии; 1. Далее сделайте pull-request в проект. https://github.com/BlizD/Tasks/pulls; 1. ВАЖНО: **выбирайте ветку `features`, а не `master` или `develope`**; - 1. ВАЖНО: **убедитесь, что Ваш fork синхронизирован с оригинальным репозиторием** `develope` \ No newline at end of file + 1. ВАЖНО: **убедитесь, что Ваш fork синхронизирован с оригинальным репозиторием** `develope` + +