Update docs/ru/development/contrib.md

Co-authored-by: olgarev <56617294+olgarev@users.noreply.github.com>
This commit is contained in:
Roman Bug 2021-07-24 14:33:15 +03:00 committed by GitHub
parent 2421b3b5a5
commit 9441054ee4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -46,7 +46,7 @@ toc_title: "Используемые сторонние библиотеки"
3. Создавайте новую ветку на основе той ветки, которую вы хотите интегрировать: например, `master` -> `clickhouse/master` или `release/vX.Y.Z` -> `clickhouse/release/vX.Y.Z`. 3. Создавайте новую ветку на основе той ветки, которую вы хотите интегрировать: например, `master` -> `clickhouse/master` или `release/vX.Y.Z` -> `clickhouse/release/vX.Y.Z`.
4. Все копии [Clickhouse-extras](https://github.com/ClickHouse-Extras) можно автоматически синхронизировать с удаленными репозиториями. Ветки `clickhouse/...` останутся незатронутыми, поскольку скорее всего никто не будет использовать этот шаблон именования в своих репозиториях. 4. Все копии [Clickhouse-extras](https://github.com/ClickHouse-Extras) можно автоматически синхронизировать с удаленными репозиториями. Ветки `clickhouse/...` останутся незатронутыми, поскольку скорее всего никто не будет использовать этот шаблон именования в своих репозиториях.
5. Добавьте подмодули в папку `contrib` репозитория ClickHouse, на который ссылаются вышеуказанные копии. Настройте подмодули для отслеживания изменений в соответствующих ветках `clickhouse/...`. 5. Добавьте подмодули в папку `contrib` репозитория ClickHouse, на который ссылаются вышеуказанные копии. Настройте подмодули для отслеживания изменений в соответствующих ветках `clickhouse/...`.
6. Каждый раз, когда необходимо внести пользовательские изменения в код библиотеки, следует создавать отдельную ветку, например `clickhouse/my-fix`. Затем эта ветка должна быть объединена в ветку, отслеживаемую подмодулем, например, `clickhouse/master` или `clickhouse/release/vX.Y.Z`. 6. Каждый раз, когда необходимо внести изменения в код библиотеки, следует создавать отдельную ветку, например `clickhouse/my-fix`. Затем эта ветка должна быть слита (`merge`) в ветку, отслеживаемую сабмодулем, например, `clickhouse/master` или `clickhouse/release/vX.Y.Z`.
7. Не добавляйте код в клоны репозитория [Clickhouse-extras](https://github.com/ClickHouse-Extras), если имя ветки не соответствует шаблону `clickhouse/...`. 7. Не добавляйте код в клоны репозитория [Clickhouse-extras](https://github.com/ClickHouse-Extras), если имя ветки не соответствует шаблону `clickhouse/...`.
8. Всегда добавляйте пользовательские изменения с учетом официального репозитория. После того как PR будет объединен из (ветки разработки/исправлений) вашего личного репозитория [Clickhouse-extras](https://github.com/ClickHouse-Extras) и подмодуль будет добавлен в репозиторий ClickHouse, следующие PR из (ветки разработки/исправлений) делайте на основе [Clickhouse-extras](https://github.com/ClickHouse-Extras) в официальном репозитории библиотеки. Это позволит убедиться, что: 1) публикуемый код имеет несколько вариант использования и важность; 2) другие пользователи также могут использовать его в своих целях; 3) поддержка кода доступна не только разработчикам ClickHouse. 8. Всегда добавляйте пользовательские изменения с учетом официального репозитория. После того как PR будет объединен из (ветки разработки/исправлений) вашего личного репозитория [Clickhouse-extras](https://github.com/ClickHouse-Extras) и подмодуль будет добавлен в репозиторий ClickHouse, следующие PR из (ветки разработки/исправлений) делайте на основе [Clickhouse-extras](https://github.com/ClickHouse-Extras) в официальном репозитории библиотеки. Это позволит убедиться, что: 1) публикуемый код имеет несколько вариант использования и важность; 2) другие пользователи также могут использовать его в своих целях; 3) поддержка кода доступна не только разработчикам ClickHouse.
9. Чтобы подмодуль начал использовать новый код из исходной ветки (например, `master`), сначала следует аккуратно выполнить слияние (`master` -> `clickhouse/master`) и только после этого подмодуль можно будет добавлен в ClickHouse. Это связано с тем, что пользовательские изменения могут быть объединены в отслеживаемой ветке (например, `clickhouse/master`) и поэтому ветка может отличаться от своего первоначального аналога (`master`). 9. Чтобы подмодуль начал использовать новый код из исходной ветки (например, `master`), сначала следует аккуратно выполнить слияние (`master` -> `clickhouse/master`) и только после этого подмодуль можно будет добавлен в ClickHouse. Это связано с тем, что пользовательские изменения могут быть объединены в отслеживаемой ветке (например, `clickhouse/master`) и поэтому ветка может отличаться от своего первоначального аналога (`master`).