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:32:47 +03:00 committed by GitHub
parent 6252251351
commit e61e36beeb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

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