Первый раз на GitHub

Logo

Привет, упражнение Hello World является сложившейся традицией в программирование
Это очень простое упражнение которое поможет вам начать работать с GitHub.
Из этого урока вы узнаете:
1. Как создать и использовать хранилище
2. Как запустить управление новой ветвью
3. Внести изменения в файл и выложить его на GitHub
4. Открыть и объединить запрос на внесение изменений

Что такое GitHub?

GitHub является платформой для совместной разработки, он позволяет вести совместную работу над проектом из любой точки мира.

Этот урок научит вас работать с базовыми вещами на GitHub (хранилищами, ветвями, и запросами на внесение изменений). Вы создадите свой собственный репозиторий Hello world
и узнаете как производить запрос на внесение изменений во время рабочего процесса на GitHub, а также популярные способы создания и обзора кода.

Нет необходимости в программирование.

Для прохождения данного урока вам понадобится учетная запись GitHub.com и доступ в итернет. Вам не нужнао знать как писать код с помощью командной строки или устанавливать окружение Git для управления версиями GitHub.

Совет: Откройте руководство в новой вкладке или в отдельном окне браузера, так чтобы вы видели его во время выполняемых действий, описанных в данном руководстве.

Шаг 1. Создание хранилища.

Хранилище обычно используется для организации одного проекта. Хранилища могут содержать файлы, папки. Изображения, видео и электронные таблицы, а также все необходимые данные необходимые нужные для вашего проекта. Мы рекомендуем включать в хранилище файлы README или файлы с подробной информацией о вашем проекте. GitHub позволяет их легко добавлять во время создания репозитория. Он также предоставляет другие общие опции такие как файлы лицензий.

Ваше Hello-world хранилище может быть местом хранения имей, ресурсов, или даже делиться и обсуждать идеи с другими разработчиками.

Чтобы создать новое хранилище нужно:
1. В верхнем правом углу, рядом с аватаром пользователя нажать на кнопку +
и затем выбрать пункт создать Хранилище
2. Придумать название вашему хранилищу например hello-world
3. Создать краткое описание вашему репозиторию.
4. Пометить пункт Select initialize this repository with a README
(инициализировать репозиторий с файлом README)
5. Нажать на кнопку Create Repository

Cоздание нового репозитория

Шаг2. Создание ветки проекта

Ветвление создается для того чтобы разработчики могли работать над другой версией одного проекта в одно и тоже время.
По умолчанию ваше новое хранилище имеет только одну ветвь (Master). Мы будем использовать ветви для того чтобы экспериментировать и вносить изменения, прежде чем отправлять их в ветвь Master.

Прежде чем создавать ответвление от основной ветки (Master), вы должны сделать копию или снимок Master’a Если кто-то внесет изменения в (Master) в то время как вы работали в вашей ветке, вы смогли бы получить эти обновления.

Схематично это показано на диаграмме:

Диаграмма ветвления

1. Create “feature” branch from “master” — ответвление от ветви Master
2. Commit changes – внесение изменений
3. Submit pul request – отправить запрос на внесение изменений
4. Discuss proposed changes – Обсудить предлагаемые изменения
5. Merge “feature” branch into “master” — слияние с ветвью Master

Это похоже на сохранение другой версии файла, что-то вроде:
1. story.txt
2. story-joe-edit.txt
3. story-joe-edit-reviewed.txt

Аналогично происходит и в репозитории GitHub

На GitHub, наши разработчики, писатели, дизайнеры используют ветви для хранения исправления ошибок и функций работая отдельно от Master’a, когда изменения готовы, они сливают их в ветку Master

Чтобы создать новую ветку:

1. Перейдите в новое хранилище hello-world
2. Нажмите на выпадающий список сверху
3. Введите название файла readme-edits в текстовом поле
4. Нажмите на Create-branch: readme-edits в синем поле

Редактирование Readme

Теперь у вас в репозитории есть две ветви: Master и readme-edits. Они будут выглядеть одинаково но не долго! Далее мы добавим наши изменения в нашей ветке

Шаг 3. Создайте и внесите изменения.

Браво! Теперь вы находитесь в ветке readme-edits, которая является точной копией ветви Master. Давайте теперь внесем некоторые изменения.

На GitHub сохраненные изменения называются фиксации. Каждая «фиксация» имеет связанное с ней «сообщение фиксации» которое объесняет почему конкретное изменение было сделано.

Чтобы сделать и зафиксировать изменения надо:
1. Нажмите на readme.md файл
2. Нажмите на значке карандаша в правом верхнем углу просмотра файлов
3. В редакторе напишите немного о себе
4. Нажмите на кнопку фиксации изменений (Commit changes)

Коммит

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

Шаг 4. Открыть запрос на внесение изменений.

Теперь когда у вас есть изменения в ответвление Master’a вы можете открыть запрос на внесение изменений.

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

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

Открыть запрос на применение изменений в README файле

1.Перейдите на вкладку внесения изменений (страница запроса) и нажмите на зеленую кнопку новый запрос изменений (New pull request)

Страница запроса

2. Выберете ветку которую вы создали (readme-edits) для сравнения с (master) оригиналом

Выбор ветки

3. Просмотрите ваши изменения на странице сравнения, убедитесь что это именно те изменения которые вы хотите внести

Различия

4. Когда вы будите уверены что это именно те изменения которые вы хотите отправить, нажмите большую зеленую кнопку создать запрос (Create Pull Request)

Создать запрос

5. Дайте вашему запросу на принятие изменений название краткое описание (ваших изменений).

Описание изменений

Когда вы закончите с вашим сообщением нажмите на кнопку (Create pull request)
Вы также можете использовать смайлы и перетаскивать изображения и gif для подробности комментария.

Шаг 5. Слияние вашего запроса на принятия изменений.

На этом последнем этапе, пришло время, слить ваши изменения (readme-edits) в главную ветвь (Master).

1. Нажмите на зеленую кнопку запроса слияния, чтобы слить изменения в ветвь (Master)
2. Нажмите на подтверждение слияния (Confirm Merge)

Слияние

3. Теперь вы можете удалить ветвь (readme-edits) так как ее изменения были включени в ветвь (Master), ветку можно удалить с помощью серой кнопки (Delete Branch) справа от фиолетовой иконки.

Удаление

Поздравляем!

Выполнив этот курс вы научились создавать проект и делать запрос на внесение изменений на GitHub.
Вот то чему вы научились в данном курсе:
1. Создавать репозиторий (хранилище) с открытым исходым кодом
2. Создавать новую ветвь и работь с ней
3. Изменять файл и выполнять изменение на GitHub
4. Открывать запрос на применение изменений и выполнять слияние

Чтобы узнать больше о силе Pull Requesrts, мы рекомендуем прочитать GitHub Flow Guide.
Вы также можете посетить GitHub исследовать и принять участие в opensource проектах

Также вы можете воспользоваться каналом Youtube: https://www.youtube.com/githubguides

Original Sourse: https://guides.github.com/activities/hello-world/

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *