Skip to content

Commit 118cf38

Browse files
committed
Добавил CONTRIBUTING.md
1 parent dd9eeda commit 118cf38

1 file changed

Lines changed: 36 additions & 0 deletions

File tree

CONTRIBUTING.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
#### Если вы хотите доработать xUnitFor1C, добро пожаловать :)
2+
3+
Нужно соблюсти очень простые правила:
4+
5+
1. Поискать задачу в списке задач (issues) проекта https://github.com/xDrivenDevelopment/xUnitFor1C/issues
6+
1. Если нет уже существующей задачи, создайте новую, в которой опишите новые требования. В этой задаче можно будет обсудить как само требование, так и реализацию.
7+
8+
Возможно, Ваше требование уже реализовано или может быть реализован другим способом, отличным от придуманного Вами.
9+
10+
1. Почитайте короткую [[инструкцию по установке фреймворка xUnitFor1C|Инструкция по установке фреймворка xUnitFor1C]]
11+
12+
1. Сделайте fork проекта
13+
![пример кнопки](https://cloud.githubusercontent.com/assets/2920817/6867971/4ec9e270-d498-11e4-93f3-75bd3d043414.png)
14+
15+
1. Получите локальную копию на своем веток `master` и `develop` - сделать `checkout` или `pull` из полученного fork для каждой из веток.
16+
1. Создайте свою собственную ветку на базе `develop`.
17+
1. Создайте пустую базу 1С. База может быть как Файловой, так и клиент-серверной.
18+
1. В Конфигураторе в базу загрузите файл конфигурации `Tests\TestConfig.cf` и обновите базу данных.
19+
1. Перезапустите конфигуратор и создайте пользователя Администратор с полными правами.
20+
1. Наличие этого пользователя важно для тестирования. ![] (http://xdd.silverbulleters.org/uploads/default/56/327c1644c254e979.png)
21+
1. Запустите Предприятие. Прогоните все тесты из `папки Tests`. Ошибок быть не должно.
22+
1. *Прогоняйте тесты согласно [Инструкции для тестирования](https://github.com/xDrivenDevelopment/xUnitFor1C/wiki/%D0%A2%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%BF%D1%80%D0%BE%D0%B4%D1%83%D0%BA%D1%82%D0%B0-xUnitFor1C)*
23+
1. Выполните необходимые для Вас доработки.
24+
1. Обязательно измените `самый минорный номер версии` в методе `Версия` модуля обработки xddTestRunner.
25+
Например, если было `2.5.0.19`, поставьте `2.5.0.20`.
26+
1. Обязательно перезагрузите Предприятие.
27+
1. Снова выполните все тесты из `папки Tests`.
28+
1. Если есть ошибки, исправьте свой код.
29+
1. Тесты исправляйте в крайнем случае, желательно только после согласования с участниками проекта.
30+
Как правило, тесты написаны не зря :)
31+
1. Если вы дорабатывали конфигурацию базы, например, добавляли метаданные для генерации тестовых данных, сохраните файл измененной конфигурации в файл `TestConfig.cf`
32+
1. Если нет ошибок во всех тестах, выполните коммит всех исправленных файлов с обязательным описанием своих правок и привязкой к созданной/найденной issue в виде `Добавлено то и это #36`
33+
1. Далее сделайте pull-request в проект. https://github.com/xDrivenDevelopment/xUnitFor1C/pulls
34+
1. ВАЖНО: **выбирайте ветку `develop`, а не `master`**
35+
1. ВАЖНО: **убедитесь, что Ваш fork синхронизирован с оригинальным репозиторием** ![](http://xdd.silverbulleters.org/uploads/default/52/fe9c6d07feaa9506.png)
36+
1. После этого Вашу работу проверят и загрузят в основной ствол.

0 commit comments

Comments
 (0)