[TASK] Контрибьютинг в Open Source (https://github.com/SENATOROVAI/intro-cs/issues/8)

.pre-commit-config.yaml

@@ -2,18 +2,18 @@ repos:
   - repo: https://github.com/mwouts/jupytext
     rev: "v1.16.4b"
     hooks:
-     - id: jupytext
-       entry: jupytext
-       language: python
-       types: [jupyter]
-       args:
-         - --from=ipynb
-         - --to=py:light
-         - --set-formats=ipynb,py:light
-         - --quiet
-         - --sync
-         - --warn-only
-       exclude: '.*\.md$'
+    - id: jupytext
+      entry: jupytext
+      language: python
+      types: [jupyter]
+      args:
+        - --from=ipynb
+        - --to=py:light
+        - --set-formats=ipynb,py:light
+        - --quiet
+        - --sync
+        - --warn-only
+      exclude: '.*\.md$' # excludes md files
   - repo: https://github.com/PyCQA/docformatter
     rev: "eb1df347edd128b30cd3368dddc3aa65edcfac38"
     hooks:
@@ -251,6 +251,9 @@ repos:
         require_serial: true
         types_or: [jupyter, markdown]
         additional_dependencies: [pydocstyle]
+        env:
+          PYTHONIOENCODING: utf-8
+
   # - repo: https://github.com/christophmeissner/pytest-pre-commit
   #   rev: 1.0.0
   #   hooks:

README.md

@@ -1,2 +1,3 @@
 # Data-Science-For-Beginners-from-scratch-SENATOROV
 Командный репозиторий.
+https://t.me/SENATOROVAI

git/stash.py

@@ -0,0 +1,68 @@
+"""Stash Conspect."""
+
+# Что делает команда git stash?
+#
+# #Сохраняет изменения в буфер обмена
+#
+# Как просмотреть список всех сохранённых изменений (стэшей)?
+#
+# #через команду git stash list
+#
+# Какая команда применяется для использования верхнего стэша?
+#
+# #команда git stash apply автоматический применяет самые верхние изменения из списка
+#
+# Как применить конкретный стэш по его номеру?
+#
+# #git stash apply stash@{номер}
+#
+# Чем отличается команда git stash apply от git stash pop?
+#
+# #git stash apply(применяет изменения из буфера обмена но не удаляет его) git stash pop(применяет и удаляет)
+#
+# Что делает команда git stash drop?
+#
+# #git stash drop stash@{номер} удалит конкретный stash.
+#
+# Как полностью очистить все сохранённые стэши?
+#
+# #git stash clear
+#
+# В каких случаях удобно использовать git stash?
+#
+# #Для чистого рабочего директория для pull и для переключение ветки без коммита
+#
+# Что произойдёт, если выполнить git stash pop, но в проекте есть конфликтующие изменения?
+#
+# #stash применится частично, а в конфликтных местах Git создаст merge-конфликты. Их нужно будет вручную разрешить и потом сделать git add для фиксации. Stash при этом удалится, даже если были конфликты.
+#
+# Можно ли восстановить удалённый стэш после выполнения git stash drop?
+#
+# #да через хэш,  git stash apply <commit_hash>
+#
+#
+# Что делает команда git stash save "NAME_STASH"
+#
+# #Добавляет изменения в буфер обмена с именем
+#
+# Что делает команда git stash apply "NUMBER_STASH"
+#
+# #применяет определённые изменения из буфера обмена
+#
+# Что делает команда git stash pop "NUMBER_STASH"
+#
+# #применяет определённые изменения из буфера обмена и удаляет его из буфера обмена
+#
+#
+
+# Сохраните текущие изменения в стэш под названием "SENATOROV ver1", вставьте скриншот из терминала
+#
+# ![image.png](attachment:image.png)
+
+# Восстановите ваш стэш "SENATOROV ver1", вставьте скриншот из терминала
+#
+# ![image.png](attachment:image.png)
+
+# Удалите все стеши из истории, вставьте скриншот из терминала
+#
+# ![image.png](attachment:image.png)

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
+}

github/opensource.py

@@ -0,0 +1,38 @@
+"""Opensource Contributing Quiz."""
+
+# #Проект в который вы отправили пул реквест, попадает под определение опенсорса:
+#
+# Есть ли у него лицензия? Обычно в корне репозитория находится файл LICENSE.
+# #
+# Напишите название понравившейся компании и ссылку на репозиторий
+# #
+# Проект активно принимает стороннюю помощь?
+# Напишите второе улучшение которое вы сделали
+# Посмотрите на коммиты в основной ветке, напишите общее количество
+# #
+# Когда был последний коммит?
+# #
+# Сколько контрибьюторов у проекта?
+# #
+# Как часто люди коммитят в репозиторий? (На GitHub выяснить это можно, кликнув по ссылке «Commits» в верхней панели.)
+# #
+# Сколько сейчас открытых ишью?
+# #
+# Быстро ли мейнтейнеры реагируют на ишью после того, когда они открываются?
+# #
+# Ведётся ли активное обсуждение ишью?
+# #
+# Есть ли недавно созданные ишью?
+# #
+# Есть ли закрытые ишью? (На странице Issues GitHub-репозитория щелкните на вкладку «Closed», чтобы увидеть закрытые ишью.)
+# #
+# Сколько сейчас открытых пул-реквестов?
+# #
+# Быстро ли мейнтейнеры реагируют на пул-реквесты после их открытия?
+# #
+# Ведётся ли активное обсуждение пул-реквестов?
+# #
+# Есть ли недавно отправленные пул-реквесты?
+# #
+# Как давно были объединены пул-реквесты? (На странице Pull Request GitHub-репозитория щелкните на вкладку «Closed», чтобы увидеть закрытые пул-реквесты.)
+# #

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
+}