# Hello World

Выполните это Hello World упражнение, чтобы узнать GitHubрабочий процесс запроса на вытягивание.

## Introduction

В этом руководстве вы GitHub узнаете, как репозитории, ветви, фиксации и запросы на вытягивание. Вы создадите собственный репозиторий Hello World и изучите GitHubрабочий процесс запроса на вытягивание, популярный способ создания и проверки кода.

В этом кратком руководстве вы выполните следующие действия:

* Создание и использование репозитория.
* Запустите и управляйте новой ветвью.
* Внесите изменения в файл и отправьте их в GitHub виде фиксаций.
* Откройте и объедините запрос на вытягивание.

### Необходимые условия

* У вас должна быть GitHub учетная запись.

* Вам не нужно знать, как кодировать, использовать командную строку или устанавливать Git (программное обеспечение управления версиями, GitHub созданное на основе).

## Шаг 1. Создание репозитория

Первое, что мы сделаем, — создать репозиторий. Репозиторий можно рассматривать как папку, содержащую связанные элементы, такие как файлы, изображения, видео или даже другие папки. Репозиторий обычно группировать элементы, принадлежащие одному и тому же проекту или тому, над которым вы работаете.

Репозитории часто включают файл сведений о проекте. Файлы README записываются в Markdown, который является простым для чтения и простого языка записи для форматирования обычного текста. Дополнительные сведения о файлах Markdown и README см. в [Базовый синтаксис написания и форматирования](/ru/enterprise-server@3.18/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) и [Управление файлом сведений о профиле](/ru/enterprise-server@3.18/account-and-profile/how-tos/profile-customization/managing-your-profile-readme).

GitHub позволяет добавлять файл README одновременно с созданием нового репозитория.
GitHub также предлагает другие распространенные варианты, такие как файл лицензии, но вам не нужно выбирать какие-либо из них сейчас.

В репозитории `hello-world` можно хранить идеи и ресурсы, а также делиться ими и обсуждать их с другими пользователями.

1. В правом верхнем углу любой страницы выберите <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-plus" aria-label="plus icon" role="img"><path d="M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z"></path></svg>, а затем нажмите кнопку **"Создать репозиторий**".

   ![Снимок экрана: раскрывающееся меню GitHub с параметрами создания новых элементов. Пункт меню "Новый репозиторий" описан в темно-оранжевый.](/assets/images/help/repository/repo-create-global-nav-update.png)

2. В поле "Имя репозитория" введите `hello-world`.

3. В поле "Описание" введите короткое описание. Например, введите "Этот репозиторий предназначен для практики GitHub потока".

4. Выберите, будет ли репозиторий **общедоступным** или **частным**.

5. Выберите параметр **Добавить файл сведений**.

6. Щелкните **Создать репозиторий**.

## Шаг 2. Создание ветви

Ветвление позволяет одновременно иметь разные версии репозитория.

По умолчанию репозиторий имеет одну ветвь с именем `main`, которая считается главной. В репозитории можно создать дополнительные ветви на основе `main`.

Ветвление полезно при добавлении новых функций в проект без изменения основного источника кода. Работа, выполняемая в других ветвях, не будет отражаться в главной ветви, пока вы не выполните ее слияние (этот процесс будет рассмотрен далее в руководстве). Ветви можно использовать для проведения экспериментов и внесения изменений перед их фиксацией в `main`.

Когда вы создаете ветвь на основе ветви `main`, создается копия или моментальный снимок `main` на этот момент времени. Если кто-то другой внес изменения в ветвь `main`, пока вы работали со своей ветвью, вы можете вытянуть эти изменения.

На этой схеме показано следующее:

* ветвь `main`;
* новая ветвь с именем `feature`;
* Путешествие, которое `feature` проходит через этапы для "Фиксация изменений", "Отправить запрос на вытягивание", и "Обсудить предложенные изменения", прежде чем он объединен в `main`

![Схема двух ветвей. Ветвь "feature" отличается от ветви main и затем объединяется обратно в основную.](/assets/images/help/repository/branching.png)

### Создание ветви

1. В репозитории \*\*\*\* перейдите на вкладку `hello-world`.

2. Над списком файлов щелкните раскрывающееся меню, которое говорит **main**.

   ![Снимок экрана: страница репозитория. Раскрывающееся меню, помеченное значком ветви и "main", выделено оранжевым контуром.](/assets/images/help/branches/branch-selection-dropdown-global-nav-update.png)

3. В текстовом поле введите имя ветви `readme-edits`.

4. Нажмите кнопку **Создать ветвь readme-edits на основе main**.

   ![Снимок экрана: раскрывающийся список ветви для репозитория. "Создать ветвь: readme-edits from 'main'' описывается в темно-оранжевый цвет.](/assets/images/help/repository/new-branch.png)

Теперь у вас две ветви: `main` и `readme-edits`. Сейчас они выглядят совершенно одинаково. Затем вы добавите изменения в новую `readme-edits` ветвь.

## Шаг 3. Внесение и фиксация изменений

Когда вы создали новую ветвь на предыдущем шаге, GitHub довели вас на кодовую страницу для новой `readme-edits` ветви, которая является копией `main`.

Вы можете вносить изменения в файлы в репозитории и сохранять их. В GitHubслучае сохраненных изменений называются фиксациями. С каждой фиксацией связано сообщение о фиксации, в котором объясняется, почему было внесено данное изменение. В сообщениях о фиксациях ведется история изменений, чтобы другие участники могли понять, что вы сделали и почему.

1. В созданной `readme-edits` ветви щелкните `README.md` файл.
2. Чтобы изменить файл, нажмите кнопку <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="Edit file" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg>.
3. В редакторе напишите немного о себе.
4. Щелкните **Зафиксировать изменения**.
5. В поле "Фиксация изменений" напишите сообщение фиксации, описывающее изменения.
6. Щелкните **Зафиксировать изменения**.

Эти изменения будут внесены только в файл сведений в вашей ветви `readme-edits`, поэтому теперь ее содержимое отличается от `main`.

## Шаг 4. Открытие запроса на вытягивание

Теперь, когда у вас есть изменения в ветви, созданной на основе `main`, можно открыть запрос на вытягивание.

Запросы на вытягивание — это сердце совместной работы GitHub. Когда вы открываете запрос на вытягивание, вы предлагаете свои изменения и просите, чтобы кто-нибудь проверил результаты вашей работы, извлек их и выполнил слияние со своей ветвью. В запросах на вытягивание показаны различия в содержимом двух ветвей. Изменения, дополнения и исключения отображаются разными цветами.

Сразу после фиксации вы можете открыть запрос на вытягивание и начать обсуждение, даже если код еще не завершен.

На этом шаге вы откроете запрос на вытягивание в собственном репозитории, а затем объедините его самостоятельно. Это отличный способ практики GitHub потока перед работой над крупными проектами.

1. В репозитории \*\*\*\* перейдите на вкладку `hello-world`.

2. Нажмите кнопку **"Создать запрос** на вытягивание".

3. В поле **Примеры сравнения** выберите созданную вами ветвь `readme-edits`, чтобы сравнить ее с `main` (исходной ветвью).

4. Просмотрите различия на странице сравнения и убедитесь в том, что они готовы к отправке.

   ![Снимок экрана: дифф для файла README.md. 3 красные строки перечисляют текст, который удаляется, и 3 зеленые строки перечисляют добавляемый текст.](/assets/images/help/repository/diffs.png)

5. Нажмите **"Создать pull request"**.

6. Укажите заголовок запроса на вытягивание и напишите краткое описание изменений. Вы можете добавлять эмодзи и перетаскивать изображения и GIF-файлы.

7. Нажмите **"Создать pull request"**.

### Проверка запроса на включение изменений

Когда вы начинаете сотрудничать с другими пользователями, это время, когда вы попросите их рецензирование. Это позволяет участникам совместной работы комментировать или предлагать изменения в запрос на вытягивание перед слиянием изменений в `main` ветви.

Мы не рассмотрим запросы на вытягивание в этом руководстве, но если вы заинтересованы в обучении больше, см [. раздел AUTOTITLE](/ru/enterprise-server@3.18/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews). Кроме того, воспользуйтесь курсом [GitHub Skills](https://skills.github.com/) "Просмотр запросов на вытягивание".

## Шаг 5. Объединение запроса на вытягивание

На этом последнем шаге вы выполните слияние ветви `readme-edits` с ветвью `main`. После слияния запроса на вытягивание изменения в вашей ветви `readme-edits` будут включены в `main`.

Иногда запрос на вытягивание может вносить изменения в код, конфликтующие с существующим кодом в `main`. Если есть конфликты, сообщит вам о конфликтующий код и предотвратит слияние до тех пор, GitHub пока не будут устранены конфликты. Вы можете выполнить фиксацию, которая устраняет конфликты, или использовать комментарии в запросе на вытягивание, чтобы обсудить конфликты с участниками команды.

При выполнении этого пошагового руководства конфликтов не должно быть, поэтому ваша ветвь готова к слиянию с главной.

1. В нижней части запроса на вытягивание нажмите кнопку **"Объединить запрос** на вытягивание", чтобы объединить изменения `main`в .
2. Щелкните **Подтвердить слияние**. Вы получите сообщение о том, что запрос был успешно объединен и закрыт.
3. Щелкните **Удалить ветвь**. Теперь, когда запрос на вытягивание объединен и изменения включены в `main`, вы можете спокойно удалить ветвь `readme-edits`. Чтобы внести дополнительные изменения в проект, вы всегда можете создать новую ветвь и повторить этот процесс.
4. Вернитесь на вкладку **"Код** " репозитория `hello-world` , чтобы просмотреть опубликованные изменения `main`.

## Conclusion

Выполнив это руководство, вы узнали, как создать проект и выполнить запрос GitHubна вытягивание.

В рамках этого мы узнали, как:

* Создайте репозиторий.
* Запустите и управляйте новой ветвью.
* Измените файл и зафиксируйте эти изменения GitHub.
* Откройте и объедините запрос на вытягивание.

## Дальнейшие действия

* Посмотрите на свой GitHub профиль, и вы увидите, что ваша работа отражается на графике вклада.
* Если вы хотите поработать с навыками, которые вы узнали в этом руководстве, попробуйте перейти к курсу [GitHub Skills](https://skills.github.com/)GitHub"Введение в".
* Персонализация профиля и изучение базового синтаксиса Markdown для записи см GitHub. в разделе [Персонализация профиля](/ru/enterprise-server@3.18/account-and-profile/tutorials/personalize-your-profile).

## Дополнительные материалы

* [поток GitHub](/ru/enterprise-server@3.18/get-started/using-github/github-flow)