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

.gitignore

@@ -240,9 +240,9 @@ coverage/
 
 
 
-*.png
-*.jpg
-*.jpeg
+#*.png
+#*.jpg
+#*.jpeg
 *.zip
 *.rar
 *.gif
@@ -251,12 +251,12 @@ coverage/
 # Common binary file extensions
 
 # Images
-*.png
-*.jpg
-*.jpeg
-*.gif
-*.bmp
-*.tiff
+#*.png
+#*.jpg
+#*.jpeg
+#*.gif
+#*.bmp
+#*.tiff
 *.ico
 # Additional image formats
 *.heic  # High Efficiency Image File Format, commonly used by Apple
@@ -333,3 +333,4 @@ coverage/
 
 /Math/calculus/theory
 /Math/school_theory
+SENATOROV/

README.md

@@ -1,2 +1,55 @@
-# Data-Science-For-Beginners-from-scratch-SENATOROV
-Командный репозиторий.
+🚀 Как работать с этим репозиторием
+
+📦 Установка
+Клонируйте репозиторий:
+
+```git clone https://github.com/savemysoul382/Data-Science-For-Beginners-from-scratch-SENATOROV.git
+cd Data-Science-For-Beginners-from-scratch-SENATOROV
+```
+
+(Рекомендуется) создайте виртуальное окружение:
+```
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+```
+
+Установите зависимости:
+```
+pip install -r requirements.txt
+```
+
+🧪 Запуск тестов (если есть)
+```
+pytest
+```
+
+📚 Генерация документации (Sphinx)
+Перейдите в папку документации:
+```
+cd docs
+```
+
+Сгенерируйте HTML-документацию:
+```
+make html
+```
+
+Откройте в браузере:
+```
+open _build/html/index.html  # Windows: start _build/html/index.html
+```
+
+🚀 Автопубликация документации
+Документация автоматически собирается и публикуется на GitHub Pages при каждом коммите в ветку main.
+
+Ссылка на документацию:
+👉 https://github.com/savemysoul382/Data-Science-For-Beginners-from-scratch-SENATOROV
+
+🛠️ Основные команды разработки
+Цель	Команда
+Установка зависимостей	```pip install -r requirements.txt```
+Запуск тестов	```pytest```
+Сборка документации	```cd docs && make html```
+Локальный просмотр доков	открыть docs/_build/html/index.html
+
+ https://t.me/RuslanSenatorov

environment.yml

@@ -0,0 +1,111 @@
+name: base
+channels:
+  - defaults
+dependencies:
+  - anaconda-anon-usage=0.7.2=py313hfc23b7f_100
+  - anaconda-auth=0.8.6=py313haa95532_0
+  - anaconda-cli-base=0.5.2=py313haa95532_0
+  - anaconda_powershell_prompt=1.1.0=haa95532_1
+  - anaconda_prompt=1.1.0=haa95532_1
+  - annotated-types=0.6.0=py313haa95532_0
+  - archspec=0.2.3=pyhd3eb1b0_0
+  - boltons=25.0.0=py313haa95532_0
+  - brotlicffi=1.0.9.2=py313h5da7b33_1
+  - bzip2=1.0.8=h2bbff1b_6
+  - ca-certificates=2025.7.15=haa95532_0
+  - certifi=2025.8.3=py313haa95532_0
+  - cffi=1.17.1=py313h827c3e9_1
+  - charset-normalizer=3.3.2=pyhd3eb1b0_0
+  - click=8.2.1=py313haa95532_0
+  - colorama=0.4.6=py313haa95532_0
+  - conda=25.7.0=py313haa95532_0
+  - conda-anaconda-telemetry=0.3.0=pyhd3eb1b0_1
+  - conda-anaconda-tos=0.2.2=py313haa95532_1
+  - conda-content-trust=0.2.0=py313haa95532_1
+  - conda-libmamba-solver=25.4.0=pyhd3eb1b0_0
+  - conda-package-handling=2.4.0=py313haa95532_0
+  - conda-package-streaming=0.12.0=py313haa95532_0
+  - cpp-expected=1.1.0=h214f63a_0
+  - cryptography=45.0.5=py313hcaec639_0
+  - distro=1.9.0=py313haa95532_0
+  - expat=2.7.1=h8ddb27b_0
+  - fmt=9.1.0=h6d14046_1
+  - frozendict=2.4.2=py313haa95532_0
+  - idna=3.7=py313haa95532_0
+  - jaraco.classes=3.4.0=py313haa95532_0
+  - jaraco.context=6.0.0=py313haa95532_0
+  - jaraco.functools=4.1.0=py313haa95532_0
+  - jsonpatch=1.33=py313haa95532_1
+  - jsonpointer=3.0.0=py313haa95532_0
+  - keyring=25.6.0=py313haa95532_0
+  - libarchive=3.7.7=h9243413_0
+  - libcurl=8.14.1=h2300eb9_1
+  - libffi=3.4.4=hd77b12b_1
+  - libiconv=1.16=h2bbff1b_3
+  - libmamba=2.0.5=hcd6fe79_1
+  - libmambapy=2.0.5=py313h214f63a_1
+  - libmpdec=4.0.0=h827c3e9_0
+  - libsolv=0.7.30=hf2fb9eb_1
+  - libssh2=1.11.1=h2addb87_0
+  - libxml2=2.13.8=h866ff63_0
+  - lz4-c=1.9.4=h2bbff1b_1
+  - markdown-it-py=2.2.0=py313haa95532_1
+  - mdurl=0.1.0=py313haa95532_0
+  - menuinst=2.3.1=py313h5da7b33_0
+  - more-itertools=10.3.0=py313haa95532_0
+  - nlohmann_json=3.11.2=h6c2663c_0
+  - openssl=3.0.17=h35632f6_0
+  - packaging=25.0=py313haa95532_0
+  - pcre2=10.42=h0ff8eda_1
+  - pip=25.1=pyhc872135_2
+  - pkce=1.0.3=py313haa95532_0
+  - platformdirs=4.3.7=py313haa95532_0
+  - pluggy=1.5.0=py313haa95532_0
+  - pybind11-abi=5=hd3eb1b0_0
+  - pycosat=0.6.6=py313h827c3e9_2
+  - pycparser=2.21=pyhd3eb1b0_0
+  - pydantic=2.11.7=py313haa95532_0
+  - pydantic-core=2.33.2=py313h215eeae_0
+  - pydantic-settings=2.6.1=py313haa95532_0
+  - pygments=2.19.1=py313haa95532_0
+  - pyjwt=2.10.1=py313haa95532_0
+  - pysocks=1.7.1=py313haa95532_0
+  - python=3.13.5=h286a616_100_cp313
+  - python-dotenv=1.1.0=py313haa95532_0
+  - python_abi=3.13=0_cp313
+  - pywin32-ctypes=0.2.2=py313haa95532_0
+  - readchar=4.0.5=py313haa95532_0
+  - reproc=14.2.4=hd77b12b_2
+  - reproc-cpp=14.2.4=hd77b12b_2
+  - requests=2.32.4=py313haa95532_0
+  - rich=13.9.4=py313haa95532_0
+  - ruamel.yaml=0.18.10=py313h827c3e9_0
+  - ruamel.yaml.clib=0.2.12=py313h827c3e9_0
+  - semver=3.0.2=py313haa95532_1
+  - setuptools=78.1.1=py313haa95532_0
+  - shellingham=1.5.0=py313haa95532_0
+  - simdjson=3.10.1=h214f63a_0
+  - spdlog=1.11.0=h59b6b97_0
+  - sqlite=3.50.2=hda9a48d_1
+  - tk=8.6.15=hf199647_0
+  - tomli=2.2.1=py313haa95532_0
+  - tqdm=4.67.1=py313h4442805_0
+  - truststore=0.10.1=py313haa95532_0
+  - typer=0.9.0=py313haa95532_0
+  - typing-extensions=4.12.2=py313haa95532_0
+  - typing-inspection=0.4.0=py313haa95532_0
+  - typing_extensions=4.12.2=py313haa95532_0
+  - tzdata=2025b=h04d1e81_0
+  - ucrt=10.0.22621.0=haa95532_0
+  - urllib3=2.5.0=py313haa95532_0
+  - vc=14.3=h2df5915_10
+  - vc14_runtime=14.44.35208=h4927774_10
+  - vs2015_runtime=14.44.35208=ha6b5a95_10
+  - wheel=0.45.1=py313haa95532_0
+  - win_inet_pton=1.1.0=py313haa95532_0
+  - xz=5.6.4=h4754444_1
+  - yaml-cpp=0.8.0=hd77b12b_1
+  - zlib=1.2.13=h8cc25b3_1
+  - zstandard=0.23.0=py313h4fc1ca9_1
+  - zstd=1.5.6=h8880b57_0
+prefix: C:\Users\serjk\miniconda3

git/stash.py

@@ -0,0 +1,52 @@
+"""13.10.2025."""
+
+# 1. Что делает команда git stash?
+# Позволяет временно сохранить незакоммиченные изменения и очистить рабочее дерево
+#
+# 2. Как просмотреть список всех сохранённых изменений (стэшей)?
+# Командой git stash list
+#
+# 3. Какая команда применяется для использования верхнего стэша?
+# git stash apply
+#
+# 4. Как применить конкретный стэш по его номеру?
+# git stash apply stash№
+#
+# 5. Чем отличается команда git stash apply от git stash pop?
+# apply применяет стэш, не удаляя его, а pop применяет и удаляет
+#
+# 6. Что делает команда git stash drop?
+# Удаляет конкретный стэш: git stash drop stash№
+#
+# 7. Как полностью очистить все сохранённые стэши?
+# git stash clear
+#
+# 8. В каких случаях удобно использовать git stash?
+# Когда нужно переключиться на другую ветку, не теряя текущие изменения
+#
+# 9. Что произойдёт, если выполнить git stash pop, но в проекте есть конфликтующие изменения?
+# Git покажет конфликты, которые нужно будет разрешить вручную
+#
+# 10. Можно ли восстановить удалённый стэш после выполнения git stash drop?
+# Нет, обычно восстановить его нельзя, в некоторых случаях можно через reflog
+#
+# 11. Что делает команда git stash save "NAME_STASH"?
+# Сохраняет изменения в стэш с указанным именем
+#
+# 12. Что делает команда git stash apply "NUMBER_STASH"?
+# Применяет выбранный стэш без его удаления
+#
+# 13. Что делает команда git stash pop "NUMBER_STASH"?
+# Применяет выбранный стэш и удаляет его из списка
+#
+# 14. Сохраните текущие изменения в стэш под названием "SENATOROV ver1", вставьте скриншот из терминала.
+# ![ver1](attachment:image.png)
+#
+# 15. Внесите любые изменения в ваш репозиторий и сохраните второй стэш под именем "SENATOROV ver2".
+# ![image-2.png](attachment:image-2.png)
+#
+# 16. Восстановите ваш стэш "SENATOROV ver1", вставьте скриншот из терминала.
+# ![image-3.png](attachment:image-3.png)
+#
+# 17. Удалите все стэши из истории, вставьте скриншот из терминала.
+# ![image-4.png](attachment:image-4.png)