diff --git a/README.md b/README.md index 2e077169..8756ed9b 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,3 @@ # Data-Science-For-Beginners-from-scratch-SENATOROV Командный репозиторий. - +https://t.me/SENATOROVAI diff --git a/github/opensource.ipynb b/github/opensource.ipynb new file mode 100644 index 00000000..2fbce0d4 --- /dev/null +++ b/github/opensource.ipynb @@ -0,0 +1,64 @@ +{ + "cells": [ + { + "cell_type": "code", + "execution_count": null, + "id": "cfc6b049", + "metadata": {}, + "outputs": [], + "source": [ + "\"\"\"Opensource Contributing Quiz.\"\"\"" + ] + }, + { + "cell_type": "markdown", + "id": "f653f0ae", + "metadata": {}, + "source": [ + "#Проект в который вы отправили пул реквест, попадает под определение опенсорса:\n", + "\n", + "Есть ли у него лицензия? Обычно в корне репозитория находится файл LICENSE.\n", + "#\n", + "Напишите название понравившейся компании и ссылку на репозиторий\n", + "#\n", + "Проект активно принимает стороннюю помощь?\n", + "Напишите второе улучшение которое вы сделали\n", + "Посмотрите на коммиты в основной ветке, напишите общее количество\n", + "#\n", + "Когда был последний коммит?\n", + "#\n", + "Сколько контрибьюторов у проекта?\n", + "#\n", + "Как часто люди коммитят в репозиторий? (На GitHub выяснить это можно, кликнув по ссылке «Commits» в верхней панели.)\n", + "#\n", + "Сколько сейчас открытых ишью?\n", + "#\n", + "Быстро ли мейнтейнеры реагируют на ишью после того, когда они открываются?\n", + "#\n", + "Ведётся ли активное обсуждение ишью?\n", + "#\n", + "Есть ли недавно созданные ишью?\n", + "#\n", + "Есть ли закрытые ишью? (На странице Issues GitHub-репозитория щелкните на вкладку «Closed», чтобы увидеть закрытые ишью.)\n", + "#\n", + "Сколько сейчас открытых пул-реквестов?\n", + "#\n", + "Быстро ли мейнтейнеры реагируют на пул-реквесты после их открытия?\n", + "#\n", + "Ведётся ли активное обсуждение пул-реквестов?\n", + "#\n", + "Есть ли недавно отправленные пул-реквесты?\n", + "#\n", + "Как давно были объединены пул-реквесты? (На странице Pull Request GitHub-репозитория щелкните на вкладку «Closed», чтобы увидеть закрытые пул-реквесты.)\n", + "#" + ] + } + ], + "metadata": { + "language_info": { + "name": "python" + } + }, + "nbformat": 4, + "nbformat_minor": 5 +} diff --git a/github/quiz.ipynb b/github/quiz.ipynb new file mode 100644 index 00000000..82e6400c --- /dev/null +++ b/github/quiz.ipynb @@ -0,0 +1,157 @@ +{ + "cells": [ + { + "cell_type": "code", + "execution_count": null, + "id": "bc037d97", + "metadata": {}, + "outputs": [], + "source": [ + "\"\"\"Contributing to the open-source note.\"\"\"" + ] + }, + { + "cell_type": "markdown", + "id": "e3f2de2a", + "metadata": {}, + "source": [ + "## GitHub\n", + "1.1. Что такое GitHub?\n", + "#бесплатный веб сервис для хостинга\n", + "1.2. Как GitHub связан с Git?\n", + "#гит отслеживает версию проекта а гитхаб это веб сервис где можно хранить версии своего проекта на удалённом сервере\n", + "1.3. Чем отличается fork репозитория от его клонирования (clone)?\n", + "#форк копирует рабочую копию проекта на ваш аккаунт гитхаб а клонироние это скачивания на вашу локальную машину для далнейшей работы с ним\n", + "1.4. Зачем нужны и как работают pull requests?\n", + "#нужен для запроса на слияние, как это работает: форкаем проект вносим свои какие то изменения, обновления, новые фичи, и отправляем запрос на слияние ветки \n", + "1.5. GitHub использует ваш почтовый адрес для\n", + "привязки ваших Git коммитов к вашей учётной записи?\n", + "#да\n", + "1.6 Какая команда генерирует SSH ключ для Доступа по SSH к репозиторию (Рисунок 83)\n", + "#Account settings>SSH keys>Add SSH key" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "6e233a65", + "metadata": {}, + "outputs": [], + "source": [] + }, + { + "cell_type": "markdown", + "id": "82ac8d22", + "metadata": {}, + "source": [ + "## Рабочий процесс с использованием GitHub\n", + "3 Напишите 8 пунктов, которые нужно сделать, чтобы внести вклад в чужой проект.\n", + "#1. Создайте форк проекта.\n", + "#2. Создайте тематическую ветку на основании ветки master.\n", + "#3. Создайте один или несколько коммитов с изменениями, улучшающих проект.\n", + "#4. Отправьте эту ветку в ваш проект на GitHub\n", + "#5. Откройте запрос на слияние на GitHub.\n", + "#6. Обсуждайте его, вносите изменения, если нужно.\n", + "#7. Владелец проекта принимает решение о принятии изменений, либо об их отклонении.\n", + "#8. Получите обновлённую ветку master и отправьте её в свой форк.\n", + "3.1.\n", + "Какие практики принято соблюдать при создании Pull Request чтобы закрыть автоматический issues?\n", + "#В описании PR использовать ключевые слова GitHub:\n", + "Closes #номер_ишью\n", + "Fixes #номер_ишью\n", + "Resolves #номер_ишью\n", + "Тогда при мерже PR issue закроется автоматически.\n", + "Какие практики принято соблюдать при создании commit чтобы закрыть автоматический issues?\n", + "#В сообщении коммита можно тоже указывать\n", + "3.2 Как отклонить/закрыть пул реквест?\n", + "#Перейти на вкладку Pull requests в репозитории.\n", + "Выбрать нужный PR.\n", + "Внизу страницы будет кнопка Close pull request.\n", + "3.3 Перед отправкой пул реквеста нужно ли создавать ишьюс?\n", + "#Не обязательно\n", + "3.4 В какой вкладке можно посмотреть список изменений который был в пул реквесте? (Рисунок 92)\n", + "#Files changed\n", + "3.5 В какой вкладке находится страница обсуждений пул реквеста? (Рисунок 94)\n", + "#Conversation" + ] + }, + { + "cell_type": "markdown", + "id": "894c5f6a", + "metadata": {}, + "source": [ + "## Создание запроса на слияние\n", + "4 Можно ли открыть пул реквест, если вы ничего не вносили в FORK?\n", + "#Нет. PR сравнивает изменения между твоей веткой/форком и оригинальным репозиторием\n", + "4.1 Что нужно сделать чтобы открыть пул реквест? (Рисунок 90)\n", + "#Внести изменения в код в своём форке.\n", + "#Закоммитить и запушить изменения в ветку.\n", + "#Нажать кнопку Compare & pull request в GitHub.\n", + "#Добавить описание и отправить PR.\n", + "4.2 Что нужно сделать Если ваш Форк устарел?\n", + "#нажать кнопку Sync fork\n", + "4.3 Что нужно сделать если в пул реквесте имеются конфликты слияния (Рисунок 96)\n", + "#①Добавляем исходный репозиторий как удалённый с именем «upstream»\n", + "#Получаем последние изменения из него\n", + "#Сливаем основную ветку в нашу тематическую\n", + "#Исправляем указанный конфликт\n", + "#Отправляем изменения в ту же тематическую ветку\n", + "\n", + "## Отрывки кода\n", + "5 Что нужно сделать Для добавления отрывка кода в комментарии к ишьюсу? (Рисунок 104)\n", + "#Для добавления отрывка кода следует обрамить его обратными кавычками.\n", + "5.1 На какую клавишу нажать клавишу чтобы выделенный текст был включён как цитата в ваш комментарий?(Рисунок 105)\n", + "#клавишу r\n", + "5.2 Как вставить картинку в ишьюс? (Рисунок 108)\n", + "#Copy/Pass, Перетащить файл в окно комментария.\n", + "\n", + "## Поддержание GitHub репозитория в актуальном состоянии\n", + "6 Как понять что ваш форк устарел?\n", + "#В GitHub показывается сообщение: “This branch is behind main by X commits”\n", + "6.1 Как обновить форк?\n", + "#В интерфейсе GitHub: кнопка Sync fork.\n", + "\n", + "## Добавление участников\n", + "7 Как добавить участников в ваш репозиторий, чтобы команда могла работать над одним репозиторием? (Рисунок 112)\n", + "#В меню Collaborators → Add people\n", + "\n", + "## Упоминания и уведомления\n", + "8 Какой символ нужен для упоминания кого-либо? (Рисунок 118)\n", + "#\"@\"\n", + "8.1 Где находится Центр уведомлений, напишите ссылку (Рисунок 121)\n", + "#https://github.com/notifications\n", + "\n", + "## Особенные файлы\n", + "9 Что такое и зачем нужен файл README\n", + "#README.md — это файл документации в корне проекта.\n", + "В нём описывается:\n", + "назначение проекта\n", + "установка\n", + "использование\n", + "примеры\n", + "\n", + "9.1 Что такое и зачем нужен файл CONTRIBUTING (Рисунок 122)\n", + "#CONTRIBUTING.md — инструкция для участников проекта:\n", + "правила внесения изменений\n", + "оформление PR\n", + "стиль кода\n", + "ссылки на обсуждения\n", + "\n", + "## Управление проектом\n", + "10 Как измененить основную ветку (Рисунок 123)\n", + "#Settings → Branches → Default branch → выбрать нужную ветку.\n", + "10. 1 Как передать проект? какая кнопка? (рисунок 124)\n", + "#Settings → Danger Zone → Transfer ownership\n", + "10.2 Что такое файл .gitignore?\n", + "#Это файл, в котором перечислены файлы и папки, которые Git должен игнорировать" + ] + } + ], + "metadata": { + "language_info": { + "name": "python" + } + }, + "nbformat": 4, + "nbformat_minor": 5 +}