engineering-playbook/docs/beginner/04-forking.md

Open Source: Работа через Форки (Fork)

Даже если вы не являетесь сотрудником компании или у вас нет прав на запись (Write) в основной репозиторий, вы всё равно можете внести свой вклад в развитие открытых проектов. Этот механизм называется Fork & Pull Request.

1. Что такое Форк (Fork)?

Fork — это создание полной независимой копии чужого репозитория в вашем личном профиле.

• Зайдите на страницу репозитория (например, platform-tutorial).
• В правом верхнем углу нажмите кнопку Fork.
• Система создаст копию по адресу ваш-логин/platform-tutorial.

2. Локальная разработка

Клонируйте свой форк на локальный компьютер, а не оригинальный репозиторий:

git clone git@r101.rexnet.cc:ваш-логин/platform-tutorial.git

Создайте новую ветку для вашей задачи:

git checkout -b docs/add-new-translation

Внесите изменения, сделайте коммит и отправьте код в свой форк:

git push origin docs/add-new-translation

3. Открытие Pull Request к оригиналу

1. Зайдите на страницу вашего форка. Система автоматически заметит, что ваша ветка опережает оригинал, и предложит создать Pull Request.
2. Убедитесь, что базовая ветка (base) — это main оригинального репозитория, а ветка сравнения (compare) — ваша новая ветка из форка.
3. Опишите ваши изменения и нажмите Create Pull Request.

Теперь мейнтейнеры (владельцы) оригинального проекта увидят ваш код. Они могут провести ревью, попросить внести правки и, в конечном итоге, слить ваш код в свой главный репозиторий. Вы официально станете контрибьютором!