[TASK] issues #2 (SENATOROVAI/intro-cs#2)

Closes SENATOROVAI/intro-cs#2

Author: nigmatullin244

python/issues.ipynb

@@ -0,0 +1,150 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c503200d",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\"\"\"[TASK] issues  #2.\"\"\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b9239e42",
+   "metadata": {},
+   "source": [
+    "### Общие вопросы\n",
+    "1. Что такое Issues на GitHub и для чего они используются?\n",
+    "    - Это инструмент для отслеживания задач, багов, который используется для планирования и управления работой в репозиториях GitHub. \n",
+    "2. Чем Issues отличаются от других инструментов управления задачами?\n",
+    "    - Это простой и гибкий трекер задач, интегрированный с самим кодом, пул-реквестами, коммитами и проектами. В отличие от корпоративных систем (например, Jira), Issues не имеют избыточных настроек, категорий и атрибутов, а их кастомизация достигается с помощью меток, майлстонов, связанных задач и автоматизации через GitHub.\n",
+    "3. Какие основные компоненты (поля) есть у каждого Issue?\n",
+    "    - Title (Заголовок)\n",
+    "    - Description (Описание)\n",
+    "    - Labels (Метки)\n",
+    "    - Assignees (Ответственные)\n",
+    "    - Milestone (Веха)\n",
+    "    - Projects (Связанные проекты)\n",
+    "    - Comments (Комментарии)\n",
+    "    - Issue type (Тип, если настроено в организации)\n",
+    "    - State (Open/Closed — открыт/закрыт)\n",
+    "    - Linked issues / Pull requests (Связанные задачи или PR)\n",
+    "\n",
+    "### Создание Issues\n",
+    "\n",
+    "1. Как создать новое Issue в репозитории?\n",
+    "    1) Заходим в файл в репозитории \n",
+    "    2) ЛКМ+shift-copy permalink\n",
+    "    3) Issues - New issue - Выбираем тип Issues\n",
+    "    4) Заполняем title и описание Issues\n",
+    "    5) Issues - set milestone\n",
+    "    6) Submit new issue\n",
+    "2. Какие данные рекомендуется указывать в описании Issue для лучшего понимания задачи?\n",
+    "    - Указать ссылку на файл кода для issues\n",
+    "    - Описание и название файла кода\n",
+    "    - Описание проблемы или задачи\n",
+    "    - Шаги для воспроизведения (если это баг)\n",
+    "    - Ожидаемое и фактическое поведение\n",
+    "    - Скриншоты или логи при необходимости\n",
+    "    - Возможные решения или идеи\n",
+    "    - Ссылки на связанные задачи или обсуждения\n",
+    "3. Какие теги (labels) можно добавить к Issue? Какие из них стандартные?\n",
+    "    - Можно добавить стандартные и кастомные\n",
+    "    - Стандартные: bug, enhancement, documentation, duplicate, good first issue, help wanted, invalid, question, wontfix\n",
+    "4. Как прикрепить Assignees (ответственных) к Issue?\n",
+    "    - Assignees - выбрать пользователя или группу\n",
+    "\n",
+    "### Работа с Issues\n",
+    "\n",
+    "1. Как использовать Labels для классификации задач?\n",
+    "    - Выставить теги в Labels в окне Issues и поставить нужные теги\n",
+    "2. Для чего нужен Milestone, и как связать его с Issue?\n",
+    "    - Для того, чтобы привязать Issue к дате или определенному этапу\n",
+    "    - Выставить дату или этап в Milestone в окне Issues\n",
+    "3. Как привязать Issue к пул-реквесту (Pull Request)?\n",
+    "    - При создании pull request или коммита указать номер Issue в #123, либо использовать ключевые слова (\"Closes #123\", \"Fixes #123\")\n",
+    "    - Можно вручную добавить связь через панель Linked issues\n",
+    "4. Как добавить комментарий к существующему Issue?\n",
+    "    - В конце страницы Issue в поле комментария — написать текст и нажать \"Comment\", чтобы добавить сообщение\n",
+    "\n",
+    "### Закрытие и завершение Issues\n",
+    "\n",
+    "1. Как закрыть Issue вручную?\n",
+    "    1) Заходим в Issues\n",
+    "    2) Находим Файл\n",
+    "    3) Ветка - main\n",
+    "    4) Редактируем файл\n",
+    "    5) Commit changes\n",
+    "    6) Commit message - тайтл Issues, Extended description - closes (Номер ошибки)\n",
+    "    7) Sing off and commit changes\n",
+    "2. Можно ли автоматически закрыть Issue с помощью сообщения в коммите или пул-реквесте? Как это сделать?\n",
+    "    - Если в сообщении коммита или pull request использовать ключевые слова: \"Closes #номер\", \"Fixes #номер\"\n",
+    "3. Как повторно открыть закрытое Issue, если работа ещё не завершена?\n",
+    "    - Вкладка Issue - Выбрать Issue - Нажать \"Reopen issue\"\n",
+    "\n",
+    "### Фильтрация и поиск\n",
+    "\n",
+    "1. Как найти все открытые или закрытые Issues в репозитории?\n",
+    "    - Во вкладке Issues по нажать \"Closed\" или в поиске, напишите is:open или is:closed для фильтрации.\n",
+    "2. Как использовать фильтры для поиска Issues по меткам, исполнителям или другим критериям?\n",
+    "    - В поиске написать, например: label:bug assignee:username milestone:\"1.0.0\", либо использовать фильтры сверху (Labels, Assignee, Milestones, Projects).\n",
+    "3. Как сортировать Issues по приоритету, дате создания или другим параметрам?\n",
+    "    - В меню (\"Sort\") на вкладке Issues: доступны опции по дате создания, обновления, количеству комментариев и т.д. Приоритет обычно выставляется ярлыками (\"priority: high\")\n",
+    "\n",
+    "### Интеграции и автоматизация\n",
+    "\n",
+    "1. Как настроить автоматические уведомления о новых или изменённых Issues?\n",
+    "    - В репозитории нажать \"Watch\" — выбрать интересующий вариант уведомлений\n",
+    "2. Что такое Projects в контексте GitHub, и как связать их с Issues?\n",
+    "    - Projects - это доски для визуального управления задачами. Issues можно добавлять в проекты для отслеживания статуса и автоматизации рабочих процессов.\n",
+    "3. Какие сторонние инструменты можно использовать для автоматизации работы с Issues (например, боты, Webhooks)?\n",
+    "    - GitHub Actions (боты и скрипты для автоматизации работ)\n",
+    "    - Webhooks для интеграции с внешними сервисами\n",
+    "    - Сторонние боты типа probot, интеграция с Jira, Trello\n",
+    "\n",
+    "### Коллаборация\n",
+    "\n",
+    "1. Как упомянуть другого пользователя в комментарии к Issue?\n",
+    "    - Использовать @username\n",
+    "2. Как запросить дополнительные данные или уточнения у автора Issue?\n",
+    "    - Использовать упоминание в комментарии. Можно дополнительно добавить label \"needs info\"\n",
+    "3. Что делать, если Issue неактуально или его нужно объединить с другим?\n",
+    "    - Для устаревших задач — закройте Issue с пометкой: \"Invalid\", \"Outdated\", кратко описав причину\n",
+    "Для объединения — оставьте ссылку на дубликат (\"Duplicate of #номер\"), закройте и используйте ярлык \"duplicate\"\n",
+    "\n",
+    "### Практические аспекты\n",
+    "\n",
+    "1. Как использовать шаблоны для создания Issues?\n",
+    "    - В разделе Settings репозитория можно добавить шаблоны Issue (Issue Templates) для разных типов задач\n",
+    "2. Что такое Linked Issues, и как создать связь между задачами?\n",
+    "    - Linked Issues - это задачи, логически связанные между собой (например, подзадачи). Связать можно с помощью панели \"Linked issues\", а также упоминания через #номер в тексте\n",
+    "3. Какие метрики (например, время выполнения) можно отслеживать с помощью Issues?\n",
+    "    - Количество открытых/закрытых задач\n",
+    "    - Время выполнения задачи\n",
+    "    - Активность по assigned/closed issues\n",
+    "    - Число комментариев\n",
+    "4. Какие best practices рекомендуются при работе с Issues в команде?\n",
+    "    - Используйте шаблоны и метки для стандартизации.\n",
+    "    - Назначайте ответственных\n",
+    "    - Описывайте задачи понятно, структурированно и без двусмысленности\n",
+    "    - Переводите устаревшие/дублирующие Issues в архив\n",
+    "    - Интегрируйте Issues в pipeline разработки через Pull Request’ы, Projects и автоматизацию"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv (3.14.0)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python",
+   "version": "3.14.0"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}