|
| 1 | +{ |
| 2 | + "cells": [ |
| 3 | + { |
| 4 | + "cell_type": "code", |
| 5 | + "execution_count": null, |
| 6 | + "id": "bc037d97", |
| 7 | + "metadata": {}, |
| 8 | + "outputs": [], |
| 9 | + "source": [ |
| 10 | + "\"\"\"Contributing to the open-source note.\"\"\"" |
| 11 | + ] |
| 12 | + }, |
| 13 | + { |
| 14 | + "cell_type": "markdown", |
| 15 | + "id": "e3f2de2a", |
| 16 | + "metadata": {}, |
| 17 | + "source": [ |
| 18 | + "## GitHub\n", |
| 19 | + "1.1. Что такое GitHub?\n", |
| 20 | + "#бесплатный веб сервис для хостинга\n", |
| 21 | + "1.2. Как GitHub связан с Git?\n", |
| 22 | + "#гит отслеживает версию проекта а гитхаб это веб сервис где можно хранить версии своего проекта на удалённом сервере\n", |
| 23 | + "1.3. Чем отличается fork репозитория от его клонирования (clone)?\n", |
| 24 | + "#форк копирует рабочую копию проекта на ваш аккаунт гитхаб а клонироние это скачивания на вашу локальную машину для далнейшей работы с ним\n", |
| 25 | + "1.4. Зачем нужны и как работают pull requests?\n", |
| 26 | + "#нужен для запроса на слияние, как это работает: форкаем проект вносим свои какие то изменения, обновления, новые фичи, и отправляем запрос на слияние ветки \n", |
| 27 | + "1.5. GitHub использует ваш почтовый адрес для\n", |
| 28 | + "привязки ваших Git коммитов к вашей учётной записи?\n", |
| 29 | + "#да\n", |
| 30 | + "1.6 Какая команда генерирует SSH ключ для Доступа по SSH к репозиторию (Рисунок 83)\n", |
| 31 | + "#Account settings>SSH keys>Add SSH key" |
| 32 | + ] |
| 33 | + }, |
| 34 | + { |
| 35 | + "cell_type": "code", |
| 36 | + "execution_count": null, |
| 37 | + "id": "6e233a65", |
| 38 | + "metadata": {}, |
| 39 | + "outputs": [], |
| 40 | + "source": [] |
| 41 | + }, |
| 42 | + { |
| 43 | + "cell_type": "markdown", |
| 44 | + "id": "82ac8d22", |
| 45 | + "metadata": {}, |
| 46 | + "source": [ |
| 47 | + "## Рабочий процесс с использованием GitHub\n", |
| 48 | + "3 Напишите 8 пунктов, которые нужно сделать, чтобы внести вклад в чужой проект.\n", |
| 49 | + "#1. Создайте форк проекта.\n", |
| 50 | + "#2. Создайте тематическую ветку на основании ветки master.\n", |
| 51 | + "#3. Создайте один или несколько коммитов с изменениями, улучшающих проект.\n", |
| 52 | + "#4. Отправьте эту ветку в ваш проект на GitHub\n", |
| 53 | + "#5. Откройте запрос на слияние на GitHub.\n", |
| 54 | + "#6. Обсуждайте его, вносите изменения, если нужно.\n", |
| 55 | + "#7. Владелец проекта принимает решение о принятии изменений, либо об их отклонении.\n", |
| 56 | + "#8. Получите обновлённую ветку master и отправьте её в свой форк.\n", |
| 57 | + "3.1.\n", |
| 58 | + "Какие практики принято соблюдать при создании Pull Request чтобы закрыть автоматический issues?\n", |
| 59 | + "#В описании PR использовать ключевые слова GitHub:\n", |
| 60 | + "Closes #номер_ишью\n", |
| 61 | + "Fixes #номер_ишью\n", |
| 62 | + "Resolves #номер_ишью\n", |
| 63 | + "Тогда при мерже PR issue закроется автоматически.\n", |
| 64 | + "Какие практики принято соблюдать при создании commit чтобы закрыть автоматический issues?\n", |
| 65 | + "#В сообщении коммита можно тоже указывать\n", |
| 66 | + "3.2 Как отклонить/закрыть пул реквест?\n", |
| 67 | + "#Перейти на вкладку Pull requests в репозитории.\n", |
| 68 | + "Выбрать нужный PR.\n", |
| 69 | + "Внизу страницы будет кнопка Close pull request.\n", |
| 70 | + "3.3 Перед отправкой пул реквеста нужно ли создавать ишьюс?\n", |
| 71 | + "#Не обязательно\n", |
| 72 | + "3.4 В какой вкладке можно посмотреть список изменений который был в пул реквесте? (Рисунок 92)\n", |
| 73 | + "#Files changed\n", |
| 74 | + "3.5 В какой вкладке находится страница обсуждений пул реквеста? (Рисунок 94)\n", |
| 75 | + "#Conversation" |
| 76 | + ] |
| 77 | + }, |
| 78 | + { |
| 79 | + "cell_type": "markdown", |
| 80 | + "id": "894c5f6a", |
| 81 | + "metadata": {}, |
| 82 | + "source": [ |
| 83 | + "## Создание запроса на слияние\n", |
| 84 | + "4 Можно ли открыть пул реквест, если вы ничего не вносили в FORK?\n", |
| 85 | + "#Нет. PR сравнивает изменения между твоей веткой/форком и оригинальным репозиторием\n", |
| 86 | + "4.1 Что нужно сделать чтобы открыть пул реквест? (Рисунок 90)\n", |
| 87 | + "#Внести изменения в код в своём форке.\n", |
| 88 | + "#Закоммитить и запушить изменения в ветку.\n", |
| 89 | + "#Нажать кнопку Compare & pull request в GitHub.\n", |
| 90 | + "#Добавить описание и отправить PR.\n", |
| 91 | + "4.2 Что нужно сделать Если ваш Форк устарел?\n", |
| 92 | + "#нажать кнопку Sync fork\n", |
| 93 | + "4.3 Что нужно сделать если в пул реквесте имеются конфликты слияния (Рисунок 96)\n", |
| 94 | + "#①Добавляем исходный репозиторий как удалённый с именем «upstream»\n", |
| 95 | + "#Получаем последние изменения из него\n", |
| 96 | + "#Сливаем основную ветку в нашу тематическую\n", |
| 97 | + "#Исправляем указанный конфликт\n", |
| 98 | + "#Отправляем изменения в ту же тематическую ветку\n", |
| 99 | + "\n", |
| 100 | + "## Отрывки кода\n", |
| 101 | + "5 Что нужно сделать Для добавления отрывка кода в комментарии к ишьюсу? (Рисунок 104)\n", |
| 102 | + "#Для добавления отрывка кода следует обрамить его обратными кавычками.\n", |
| 103 | + "5.1 На какую клавишу нажать клавишу чтобы выделенный текст был включён как цитата в ваш комментарий?(Рисунок 105)\n", |
| 104 | + "#клавишу r\n", |
| 105 | + "5.2 Как вставить картинку в ишьюс? (Рисунок 108)\n", |
| 106 | + "#Copy/Pass, Перетащить файл в окно комментария.\n", |
| 107 | + "\n", |
| 108 | + "## Поддержание GitHub репозитория в актуальном состоянии\n", |
| 109 | + "6 Как понять что ваш форк устарел?\n", |
| 110 | + "#В GitHub показывается сообщение: “This branch is behind main by X commits”\n", |
| 111 | + "6.1 Как обновить форк?\n", |
| 112 | + "#В интерфейсе GitHub: кнопка Sync fork.\n", |
| 113 | + "\n", |
| 114 | + "## Добавление участников\n", |
| 115 | + "7 Как добавить участников в ваш репозиторий, чтобы команда могла работать над одним репозиторием? (Рисунок 112)\n", |
| 116 | + "#В меню Collaborators → Add people\n", |
| 117 | + "\n", |
| 118 | + "## Упоминания и уведомления\n", |
| 119 | + "8 Какой символ нужен для упоминания кого-либо? (Рисунок 118)\n", |
| 120 | + "#\"@\"\n", |
| 121 | + "8.1 Где находится Центр уведомлений, напишите ссылку (Рисунок 121)\n", |
| 122 | + "#https://github.com/notifications\n", |
| 123 | + "\n", |
| 124 | + "## Особенные файлы\n", |
| 125 | + "9 Что такое и зачем нужен файл README\n", |
| 126 | + "#README.md — это файл документации в корне проекта.\n", |
| 127 | + "В нём описывается:\n", |
| 128 | + "назначение проекта\n", |
| 129 | + "установка\n", |
| 130 | + "использование\n", |
| 131 | + "примеры\n", |
| 132 | + "\n", |
| 133 | + "9.1 Что такое и зачем нужен файл CONTRIBUTING (Рисунок 122)\n", |
| 134 | + "#CONTRIBUTING.md — инструкция для участников проекта:\n", |
| 135 | + "правила внесения изменений\n", |
| 136 | + "оформление PR\n", |
| 137 | + "стиль кода\n", |
| 138 | + "ссылки на обсуждения\n", |
| 139 | + "\n", |
| 140 | + "## Управление проектом\n", |
| 141 | + "10 Как измененить основную ветку (Рисунок 123)\n", |
| 142 | + "#Settings → Branches → Default branch → выбрать нужную ветку.\n", |
| 143 | + "10. 1 Как передать проект? какая кнопка? (рисунок 124)\n", |
| 144 | + "#Settings → Danger Zone → Transfer ownership\n", |
| 145 | + "10.2 Что такое файл .gitignore?\n", |
| 146 | + "#Это файл, в котором перечислены файлы и папки, которые Git должен игнорировать" |
| 147 | + ] |
| 148 | + } |
| 149 | + ], |
| 150 | + "metadata": { |
| 151 | + "language_info": { |
| 152 | + "name": "python" |
| 153 | + } |
| 154 | + }, |
| 155 | + "nbformat": 4, |
| 156 | + "nbformat_minor": 5 |
| 157 | +} |
0 commit comments