---

Добро пожаловать в команду SENATOROVAI!

• Выполни инструкцию ниже, если возникнут трудности смело пиши: https://t.me/c/1937296927/2415

---

Оглавление

• Регистрация аккаунтов
• Скачивание и установка программ
• Скачайте репозиторий на свой компьютер
• Update branch(Github)
• Update branch(VS CODE)
• Resolve conflicts with merge branch
• Check hw (проверка домашек)

---

Расскажи о себе, прошлый опыт, цель обучения, где живешь, лучше пиши на английском, коллеги англоязычные, русский их не родной,

• Сообщение отправь сюда Тык

---

Регистрация аккаунтов

1. GitHub
   • Перейдите на GitHub и зарегестрируйся согласно инструкции.
   • Нажмите "Sign up" и следуйте инструкциям для создания аккаунта.
   • После регистрации поделитесь ссылкой на ваш профиль GitHub в чате: Telegram Chat, в посте добавьте @ВашЮзерНеймТелеграм хэштег #githubaccount
   • Настройте Github:
   • оформить гитхаб https://www.youtube.com/watch?v=pm17VwdJ6UI
   • выберите шаблон https://github.com/abhisheknaiidu/awesome-github-profile-readme
   • Повторите 5 пунктов
   • 

---

2. Kaggle

   • Что такое КЭГГЛ?

   • Посетите Kaggle.

   • Нажмите "Sign up" и создайте аккаунт.

   • Подтвердите номер телефона на Kaggle (АКТУАЛЬНО ДЛЯ РФ) Видео инструкция

   • Используйте этот номер для Kaggle: 365sms.ru

   • Получите статус контрибьютора на Kaggle: Видео инструкция

   • Подпишитесь на коллег https://t.me/c/1937296927/832/21039

   • Заполните профиль

   
   • Поделитесь ссылкой на ваш профиль Kaggle в чате: Telegram Chat. в посте добавьте @ВашЮзерНеймТелеграм хэштег #kaggleaccount
   • Загрузка ноутбуков на Kaggle

---

4. ODS.AI
   • Перейдите на ODS.AI.
   • Зарегистрируйтесь для создания аккаунта.
   • Поделитесь ссылкой на ваш профиль ODS.AI в чате: Telegram Chat. в посте добавьте @ВашЮзерНеймТелеграм хэштег #odsaccount

---

Скачивание и установка программ

1. GitHub Desktop
   • Скачайте с GitHub Desktop.
   • Следуйте инструкциям по установке для вашей операционной системы.

---

2. Cursor

   • Скачайте с Cursor.

   • Установите согласно предоставленным инструкциям.

   • 

   • (установить плагины):

   • 
     • ms-python.pylint
     • ms-python.flake8
     • ms-python.mypy-type-checker
     • matangover.mypy
     • ms-pyright.pyright
     • ms-python.black-formatter
     • njpwerner.autodocstring
     • njqdev.vscode-python-typehint
     • KevinRose.vsc-python-indent
     • mintlify.document
     • streetsidesoftware.code-spell-checker
     • eamodio.gitlens
     • ms-toolsai.jupyter
     • ms-vsliveshare.vsliveshare
     • njqdev.vscode-python-typehint
     • EricSia.pythonsnippets3
     • ms-pyright.pyright
     • congyiwu.vscode-jupytext
     • streetsidesoftware.code-spell-checker-russian

---

  Активация русского языка
  Commands (use F1 or View -> Command Palette):
  
      Enable Russian Spell Checker Dictionary
      Enable Russian Spell Checker Dictionary in Workspace
  Добавить слово в словарь => наводим на слово и нажимаем ctrl+. потом выбираем add to user settings

---

• Настройте курсор(vscode на видео) к работе

• Кнопка "vs code settings" ,для wrap и т.д.

• Посмотрите возможности курсора

3. Python (CPython)
   • Скачайте с CPython.
   • Следуйте руководству по установке для вашей платформы.

---

4. Git for Windows
   • Скачайте с Git for Windows.
   • Установите, следуя инструкциям по настройке.

---

5. Conda
   • Скачайте с Conda.
   • Следуйте инструкциям по установке для вашей системы.

---

• Джамборд для учёбы
  • Посмотрите видеоинструкцию: YouTube
  • ЕСЛИ ВЫ НЕ МОЖЕТЕ ЗАЙТИ НА САЙТ https://www.canva.com/, выполните инструкцию
  • Скиньте мне в личку ссылку на ваш джамборд.

---

Скачайте репозиторий на свой компьютер.

1. Поставьте звезду репозиторию
   • Убедитесь, что вы поставили звезду репозиторию, https://github.com/SENATOROVAI/Data-Science-For-Beginners-from-scratch-SENATOROV

---

2. Присоединитесь к команде

   • Примите приглашение https://github.com/settings/organizations

     

   • Если вас нет в списке команды Senatorov, отправьте сообщение в чат здесь с:

     • Вашим логином в Telegram
     • Ссылкой на ваш профиль GitHub
     • в посте добавьте хэштеги #githubaccount #senatorovteam

   • подпишитесь на коллег https://github.com/orgs/SENATOROVAI/teams/senatorov-team

---

1. Создайте новую ветку
   • Перейдите на страницу веток и создайте новую ветку, назвав её вашим логином GitHub без СОБАЧКИ @.

• Пример

4. Клонируйте репозиторий
   • Скачайте репозиторий на ваш локальный компьютер, нажимаем code->open with Github Desktop

4.1 (опционально)Клонирование конкретной ветки

• откройте терминал/командную строку, перейдите в ваш репозиторий с помощью команды cd Documents/github/
• git clone --branch название-ветки https://github.com/SENATOROVAI/Data-Science-For-Beginners-from-scratch-SENATOROV.git
• cd Data-Science-For-Beginners-from-scratch-SENATOROV
• cursor .

5. Переключите ветки
   • переключите ветку в GitHub Desktop, выберите ветку с ВАШЕМ логином

5.1 Откройте курсор в github desktop и переключите в нем ветки

6. Введите команды в терминал
   • Откройте терминал и убедитесь что там написано Data-Science-For-Beginners-from-scratch-SENATOROV

• Затем вставьте 4 команды ниже, в терминал, по очереди, и нажмите каждый раз Enter
• git init
• pip install pre-commit
• pre-commit install
• pre-commit run --all-files

---

• Документация по линтерам:
• Pylint https://pylint.pycqa.org
• Pydocstyle https://docs.astral.sh/ruff/rules/#pydocstyle-d
• Flake8 https://flake8.pycqa.org/en/latest/index.html
• Mypy https://mypy.readthedocs.io/en/stable/cheat_sheet_py3.html#variables

---

7. Пришлите скриншот вашего терминала

   • Сделайте полный скриншот вашего терминала на весь экран и пришлите в чат пример скриншота
   

• Если у вас есть локальный репозиторий на компьютере с вашими файлами, скопируйте ваши файлы из documents/github/ваш_репозиторий, в новый репозиторий Documents/github/Data-Science-For-Beginners-from-scratch-SENATOROV

7.1 Посмотрите процесс принятие и отправки коммитов и работе с линтером создайте файл log.ipynb, в нем напишите дату и тезисно по пунктам что сделали, потом отправьте коммит как написано в пункте 7.2, а не как в видео через Github Desktop.

7.2 Затрекайте свои временные изменения в коммит, нажмите "+" чтобы внести изменения в трекинг систему гит

• Список Changes должен быть пустым

• Дополнительно можете ещё раз убедиться что всё готово к слиянию веток, введите в терминал:git status, список файлов должен быть зелёный

• чтобы сделать пустую строку между тайтл и дескрипшен жмём shift+enter, если в коммите участвуют системные файлы, которые я добавил, значит пишете, "update system files", отправьте коммит нажатием на кнопку commit&sync

• заходим в свой коммит: https://github.com/SENATOROVAI/Data-Science-For-Beginners-from-scratch-SENATOROV/commits/ИМЯ-ВЕТКИ/, ИМЯ-ВЕТКИ меняйте на ваш логин гитхаб, вставляете ссылку в url, и копируете ссылку на последний коммит
• присылаем ссылку на коммит сюда https://t.me/c/1937296927/765

8. Ознакомиться с системой штрафов и бонусов

   • Штрафы и Бонусы

9. Список домашних заданий и дедлайнов

   • Здесь будет ваша домашка Homework and deadline, "senatorov-team" - это общая домашка для ВСЕХ, так же персональная домашка я буду указывать ваш @логин
   • Ссылки на выполненную домашку нужно присылать сюда, проверка домашек только через пул реквест
   • если я ставлю собачку на вас в этом чате значит вам пришла домашняя работа, вы должны найти свой логин в milestones

10. Ознакомиться с системой помощи в комьюнити

• Инструкция помощь
• Практика запроса помощи или сообщения о проблеме

11. Ознакомиться с отменой занятий

• Отмена занятий

12. Программа обучения

• Выбери план обучения
• Ознакомься с программой обучения

13. Важные анонсы крайте нежелательно пропускать

• Критические уведомления

15. Персональное обращение

• регулярно проверяйте что вас не тегнули
• помогайте другим коллегам решать их тикеты и получайте бонусы, ищите хэштег #open

16. Обязательно сделайте все задания

• => Задания

17. Включите отображение активности

• https://github.com/settings/profile (Include private contributions on my profile)

18. Делайте ревью кода(возьмите на заметку)

• проверяйте наличие запросов на ревью
• Чем быстрее вы научитесь делать ревью, тем быстрее вы станете ПРОФЕССИОНАЛОМ

ПОЗДРАВЛЯЮ! ВЫ ГОТОВЫ К ОБУЧЕНИЮ, Сообщите в чат что сделали intro и я задам вам домашнюю работу.

---

1. update branch => способ через гитхаб

   • Если в чате GitHub вас просят "обновите ветки/update branch", создайте пулреквест из ветки main в вашу ветку. Используйте страницу сравнения, чтобы выбрать вашу ветку и инициировать пулреквест.
   • В title пул реквеста пишите update branch
   • Нажимаем create pull requests
   • Скролим в самый низ и нажимаем "merge pull requests", если там написано "conflict", то жми сюда
   • Нажимаем confirm merge
   • Внимательно проверьте какие изменения были добавлены в вашу ветку
   
   • сделай git pull

   Resolve conflicts

   • Если возникает конфликт при слиянии, нажимаем "web editor", или "github desktop"
   • Нажимаем Resolve
   • Устраняем конфликт вручную, путём вырезания ненужных строк
   • Нажимаем Mark as resolved

---

2. Сложный конфликт

• Сложные конфликты решаем в VSCODE

Commit (Переходим в курсор и жмём на клиент гита)

• Затрекайте свои временные изменения в коммит, нажмите "+" чтобы внести изменения в трекинг систему гит
• Список Changes должен быть пустым

• Дополнительно можете ещё раз убедиться что всё готово к слиянию веток, введите в терминал:git status, список файлов должен быть зелёный

• чтобы сделать пустую строку между тайтл и дескрипшен жмём shift+enter, если в коммите участвуют системные файлы, которые я добавил, значит пишете, "update system files", Отправляем коммит нажатием на кнопку commit&sync

• git pull

update branch => способ через VSCODE

• Отдайте коммит
• Приступаем к слиянию веток, внизу слева, должна быть написана ваша ветка, которую вы создали
• Нажимаем 3 точки, merge

• выбираем из какой ветки будем мержиться, нажимаем на "origin/main remote branch", то есть с той ветки которая лежит на сайте гитхаб, а не ,main которая у вас на компе, поздравляю, вы успешно обновили ветку, но иногда надо устранять конфликты вручную, поэтому если это ваш случай, читайте дальше доку.

Нажимаем на восклицательный знак и решаем конфликт вручную

• Нажимаем accept current change , это то что пришло с гитхаба, наши локальные данные удаляться.

• отдаём коммит, ВЫ УСПЕШНО РЕШИЛИ КОНФЛИКТ И ОБНОВИЛИ ВЕТКУ!

---

Дальнейшее обучение и портфолио

• Портфолио

• Все дальнейшее обучение и вклад будут осуществляться в этом репозитории.

Следуя этим структурированным шагам, вы сможете обеспечить гладкий процесс внесения изменений и оставаться в соответствии с руководящими принципами репозитория.

---

Check hw

• Создаёте ишьюс, у вас 3 варианта:

• ишьюс-вопрос

• ишьюс-улучшение, если хотите помочь мне улучшить документацию, структуру папок и заработать баллы

• ишьюс-баг

• пишете содержательный тайтл, дескрипшен, запоминаете номер ишьюса, вы его будете вставлять в пул реквест, инструкция как создать ишьюс

• Пример

• Вы можете попросить чтобы я проверил:

1. сразу весь файл
2. блок кода
3. одну строку, кнопка "Copy permalink" нужно кликнуть на конкретную строку или выделить несколько строк,

• Открываете пул реквест в ветку main, Тайтл копируем из ишьюс, в дескрипшен пишем Closes #НомерИшьюса, в моём примере это Closes #35

• Присылайте ссылку на ишьюс в https://t.me/c/1937296927/3602, в посте пишете:
• копируете тайтл из ишьюса и добавляете 2 хэштега #open #issues
• Когда я проверю вашу домашку, я пришлю ссылку на ревью, в ответ на ваше сообщение, вам нужно будет поменять статус в посте на #closes

---

Если у вас есть вопросы или нужна дополнительная помощь, не стесняйтесь спрашивать здесь!