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:42:30 +03:00 committed by GitHub
parent 9ddd6616f5
commit 2036ab8d63
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -48,5 +48,5 @@ toc_title: "Используемые сторонние библиотеки"
5. Добавьте сабмодули в папку `contrib` репозитория ClickHouse, на который ссылаются клонированные репозитории. Настройте сабмодули для отслеживания изменений в соответствующих ветках `clickhouse/...`.
6. Каждый раз, когда необходимо внести изменения в код библиотеки, следует создавать отдельную ветку, например `clickhouse/my-fix`. Затем эта ветка должна быть слита (`merge`) в ветку, отслеживаемую сабмодулем, например, `clickhouse/master` или `clickhouse/release/vX.Y.Z`.
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`).