diff --git a/docs/welcome/intro_eng.md b/docs/welcome/intro_eng.md deleted file mode 100644 index 44668739..00000000 --- a/docs/welcome/intro_eng.md +++ /dev/null @@ -1,89 +0,0 @@ -### Register Accounts - -1. **GitHub** - - Go to [GitHub](https://github.com/). - - Click on "Sign up" and follow the instructions to create an account. - - Once registered, share your GitHub profile link in the chat: [Telegram Chat](https://t.me/c/1937296927/3602). - -2. **Kaggle** - - Visit [Kaggle](https://www.kaggle.com/). - - Click on "Sign up" and create an account. - - Confirm your phone number on Kaggle (RELEVANT FOR RUSSIA) [Video Guide](https://youtu.be/fcBOlOl__T0) - - Use this number for Kaggle: [365sms.ru](https://365sms.ru/) - - - Obtain Contributor Status on Kaggle: [Video Guide](https://youtube.com/shorts/A_EtBko0T3U?feature=shared) - - Share your Kaggle profile link in the chat: [Telegram Chat](https://t.me/c/1937296927/832). - -3. **ODS.AI** - - Go to [ODS.AI](https://ods.ai/). - - Register for an account. - - Share your ODS.AI profile link in the chat: [Telegram Chat](https://t.me/c/1937296927/832). - -### Download and Install Software - -1. **GitHub Desktop** - - Download from [GitHub Desktop](https://github.com/desktop/desktop). - - Follow the installation instructions for your operating system. - -2. **Cursor** - - Download from [Cursor](https://github.com/getcursor/cursor). - - Install it according to the provided instructions. - -3. **Python (CPython)** - - Download from [CPython](https://github.com/python/cpython). - - Follow the installation guide for your platform. - -4. **Git for Windows** - - Download from [Git for Windows](https://github.com/git-for-windows/git). - - Install it using the setup instructions. - -5. **Conda** - - Download from [Conda](https://github.com/conda/conda). - - Follow the installation instructions for your system. - -### Additional Resources - -- **Jamboard for Learning** - - Watch the video guide: [YouTube](https://youtu.be/8pwKgbMyfbo) - - Use [Canva](https://www.canva.com/) to create and share Jamboards. - - Send me the link to your Jamboard in a private message. - -### Download the Repository to Your Computer - -### Detailed Instructions - -1. **Star the Repository** - - Make sure you have starred the repository. https://github.com/SENATOROVAI/Data-Science-For-Beginners-from-scratch-SENATOROV - ![image](https://github.com/user-attachments/assets/aa4e7946-d65f-4f5f-91a2-84a1dc3bdcb4) - -2. **Join the Team** - - If you are not listed in the [Senatorov Team](https://github.com/orgs/SENATOROVAI/teams/senatorov-team), send a message in the chat [here](https://t.me/c/1937296927/3602) with: - - Your Telegram username - - Your GitHub profile link - -3. **Create a New Branch** - - Go to the [branches page](https://github.com/SENATOROVAI/GithubLogin-Data-Science-For-Beginners-from-scratch-SENATOROV/branches) and create a new branch named after your [GitHub username](https://github.com/settings/admin). - - Example ![image](https://github.com/user-attachments/assets/09181e62-84f8-4992-86a4-13394c7a014a) - -4. **Clone the Repository** - - Download the repository to your local machine using any convenient method. I recommend GitHub Desktop. - Screenshot 2024-11-27 at 4 01 19 AM - -5. **Switch Branches** - - Ensure you switch to your newly created branch in GitHub Desktop. - ![image](https://github.com/user-attachments/assets/82f6acc8-3e4f-4abd-bc9b-0514a47056f4) - Screenshot 2024-11-27 at 4 26 31 AM - -### Submitting Changes - -1. **Update Branches** - - If requested in the GitHub chat, update your branch by creating a pull request from the `main` branch to your branch. Use the [compare page](https://github.com/SENATOROVAI/Data-Science-For-Beginners-from-scratch-SENATOROV/compare) to select your branch and initiate the pull request. - ![image](https://github.com/user-attachments/assets/e027f42e-a66f-42db-a52a-3a6319903ee8) - -### Ongoing Learning - -- All further learning and contributions will be conducted within this repository. - -By following these structured steps, you can ensure a smooth contribution process and stay aligned with the repository's guidelines. - -If you have any questions or need further assistance, feel free to ask! diff --git a/docs/welcome/intro_ru.md b/docs/welcome/intro_ru.md deleted file mode 100644 index 7e4e86bd..00000000 --- a/docs/welcome/intro_ru.md +++ /dev/null @@ -1,310 +0,0 @@ -![photo_2024-01-16_20-54-32](https://github.com/user-attachments/assets/fe349ddc-47df-40f7-80b9-5758c15373c7) - ---- - -

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

- --

Старые студенты сразу переходят к этому пункту, при условии что предыдущие выполнены

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

Оглавление

- - ---- - -### Расскажи о себе, прошлый опыт, цель обучения, где живешь, лучше пиши на английском, коллеги англоязычные, русский их не родной, - - Сообщение отправь сюда [Тык](https://t.me/c/1937296927/3181) - ---- - -### Регистрация аккаунтов - -1. **GitHub** - - Перейдите на [GitHub](https://github.com/). - - Нажмите "Sign up" и следуйте инструкциям для создания аккаунта. - - После регистрации поделитесь ссылкой на ваш профиль GitHub в чате: [Telegram Chat](https://t.me/c/1937296927/3602), в посте добавьте @ВашЮзерНеймТелеграм хэштег #githubaccount - - Настройте Github: - - подписаться на коллег https://github.com/orgs/SENATOROVAI/teams/senatorov-team - - оформить гитхаб https://www.youtube.com/watch?v=pm17VwdJ6UI - - выберите шаблон https://github.com/abhisheknaiidu/awesome-github-profile-readme - - Повторите 5 пунктов - - Example - ---- - -2. **Kaggle** - - [Что такое КЭГГЛ?](https://youtu.be/wL9zQczbHRs) - - Посетите [Kaggle](https://www.kaggle.com/). - - Нажмите "Sign up" и создайте аккаунт. - - Подтвердите номер телефона на Kaggle (АКТУАЛЬНО ДЛЯ РФ) [Видео инструкция](https://youtu.be/fcBOlOl__T0) - - Используйте этот номер для Kaggle: [365sms.ru](https://365sms.ru/) - - - Получите статус контрибьютора на Kaggle: [Видео инструкция](https://youtube.com/shorts/A_EtBko0T3U?feature=shared) - - Подпишитесь на коллег https://t.me/c/1937296927/832/21039 - - Заполните профиль - - Example - - - Поделитесь ссылкой на ваш профиль Kaggle в чате: [Telegram Chat](https://t.me/c/1937296927/832). в посте добавьте @ВашЮзерНеймТелеграм хэштег #kaggleaccount - - [Загрузка ноутбуков на Kaggle](https://youtu.be/Kn9ZcXlCApw) - ---- - -4. **ODS.AI** - - Перейдите на [ODS.AI](https://ods.ai/). - - Зарегистрируйтесь для создания аккаунта. - - Поделитесь ссылкой на ваш профиль ODS.AI в чате: [Telegram Chat](https://t.me/c/1937296927/832). - - - -### Скачивание и установка программ - -1. **GitHub Desktop** - - Скачайте с [GitHub Desktop](https://github.com/desktop/desktop). - - Следуйте инструкциям по установке для вашей операционной системы. - ---- - -2. **Cursor** - - Скачайте с [Cursor](https://github.com/getcursor/cursor). - - Установите согласно предоставленным инструкциям. - - Example - - (установить плагины): - - Example - - - - 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 на видео) к работе](https://www.youtube.com/watch?v=Si9MfV8uJ-0) - - Кнопка "vs code settings" ,для wrap и т.д. Example - - - **Посмотрите [возможности курсора](https://www.youtube.com/watch?v=hjBCRVYE1as&feature=youtu.be)** - - Посмотрите [процесс принятие и отправки домашних заданий на гитхаб](https://youtu.be/hW_7hodGxVU?si=tCEVs00xGt2q61eW) - ---- - -3. **Python (CPython)** - - Скачайте с [CPython](https://github.com/python/cpython). - - Следуйте руководству по установке для вашей платформы. - - Повторите видео [Интерпритатор Cpython и PYPY](https://youtu.be/ooLcXygrLnU) - ---- - -4. **Git for Windows** - - Скачайте с [Git for Windows](https://github.com/git-for-windows/git). - - Установите, следуя инструкциям по настройке. - ---- - -5. **Conda** - - Скачайте с [Conda](https://github.com/conda/conda). - - Следуйте инструкциям по установке для вашей системы. - ---- - -- **Джамборд для учёбы** - - Посмотрите видеоинструкцию: [YouTube](https://youtu.be/8pwKgbMyfbo) - - Используйте [Canva](https://www.canva.com/) для создания и обмена джамбордами. - - Скиньте мне в личку ссылку на ваш джамборд. - ---- - -### Скачайте репозиторий на свой компьютер. - -1. **Поставьте звезду репозиторию** - - Убедитесь, что вы поставили звезду репозиторию, https://github.com/SENATOROVAI/Data-Science-For-Beginners-from-scratch-SENATOROV -![image](https://github.com/user-attachments/assets/aa4e7946-d65f-4f5f-91a2-84a1dc3bdcb4) - ---- - -2. **Присоединитесь к команде** - - Если вас нет в списке [команды Senatorov](https://github.com/orgs/SENATOROVAI/teams/senatorov-team), отправьте сообщение в чат [здесь](https://t.me/c/1937296927/3602) с: - - Вашим логином в Telegram - - Ссылкой на ваш профиль GitHub - - в посте добавьте хэштеги #githubaccount #UsernameTelegram - -1. **Создайте новую ветку** - - Перейдите на [страницу веток](https://github.com/SENATOROVAI/GithubLogin-Data-Science-For-Beginners-from-scratch-SENATOROV/branches) и создайте новую ветку, назвав её вашим [логином GitHub](https://github.com/settings/admin) без СОБАЧКИ @. - -![image](https://github.com/user-attachments/assets/99f05e36-f698-486a-8f95-50225043fb22) - -- Пример ![image](https://github.com/user-attachments/assets/09181e62-84f8-4992-86a4-13394c7a014a) -4. **Клонируйте репозиторий** - - Скачайте репозиторий на ваш локальный компьютер, нажимаем code->open with Github Desktop - -Screenshot 2024-11-27 at 4 26 31 AM - - -4.1 **(опционально)Клонирование конкретной ветки** - -- откройте терминал/командную строку, перейдите в ваш репозиторий с помощью команды ``cd documents/github/`` -- `` git clone --branch название-ветки https://github.com/SENATOROVAI/Data-Science-For-Beginners-from-scratch-SENATOROV.git `` -- ``cursor .`` - -5. **Переключите ветки** - - Убедитесь, что вы переключились на вашу новую ветку в GitHub Desktop. - Example - -5.1 **Откройте курсор в github desktop и переключите в нем ветки** - Example -Screenshot 2024-11-27 at 4 26 31 AM - -6. **Введите команды в терминал** - - Откройте терминал и убедитесь что там написано Data-Science-For-Beginners-from-scratch-SENATOROV - Example - - ![изображение](https://github.com/user-attachments/assets/6145231b-a5b4-488b-967a-5d4ed9b995a5) - - Затем вставьте 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. **Пришлите скриншот вашего терминала** - - Сделайте полный скриншот вашего терминала на весь экран и пришлите в [чат](https://t.me/c/1937296927/3602) пример скриншота - - ![изображение](https://github.com/user-attachments/assets/10d94e1b-e7fa-44db-b82b-99674b837466) - -7.1 **Если у вас есть локальный репозиторий на компьютере с вашей домашней работой, скопируйте ТОЛЬКО файлы и папки с домашней работой из documents/github/ваш_репозиторий, в новый репозиторий Documents/github/Data-Science-For-Beginners-from-scratch-SENATOROV** - -7.2 Отправляем коммит - -8. **Ознакомиться с системой штрафов** - - [Штрафы](https://t.me/c/1937296927/11810/11811) - -9. **Ознакомиться с системой бонусов** - - [Бонусы](https://t.me/c/1937296927/25305/25306) - -10. **Ознакомиться с системой помощи в комьюнити** - - [Инструкция помощь](https://t.me/c/1937296927/2415/23729) - - [Практика запроса помощи или сообщения о проблеме](https://youtu.be/wR3gXOiRm10) - -11. **Ознакомиться с отменой занятий** - - [Отмена занятий](https://t.me/c/1937296927/26659/27648) -12. **Ознакомиться с программой обучения** - - [Программа обучения](https://t.me/c/1937296927/10385/14516) -13. **Важные анонсы крайте нежелательно пропускать** - - [Критические уведомления](https://t.me/c/1937296927/26659) -14. **Чат HomeWork** - - если я ставлю собачку на вас в этом чате значит вам пришла домашняя работа [чат](https://t.me/c/1937296927/4496) - - после выполнения ДЗ и отправки коммита вы должны приложить в этот чат ссылку на него -15. **Персональное обращение** - - регулярно проверяйте что вас [не тегнули](https://t.me/c/1937296927/2415/25595) - - помогайте другим коллегам решать их тикеты и [получайте бонусы](https://t.me/c/1937296927/25305/25306), ищите хэштег #open - Example - -16. **Ответьте на квизы и пришлите пул реквест** - - [Квиз](https://github.com/SENATOROVAI/Data-Science-For-Beginners-from-scratch-SENATOROV/issues/2) -17. **Внимательно прочитайте инструкцию по git** - - [git](https://github.com/SENATOROVAI/Data-Science-For-Beginners-from-scratch-SENATOROV/blob/main/docs/git/intro_to_git.ipynb) -18. **Приступите к практике по git** - - [git задание](https://github.com/SENATOROVAI/Data-Science-For-Beginners-from-scratch-SENATOROV/issues/11) - - [git course](https://learngitbranching.js.org/?locale=ru_RU) - (опционально) доп курс по гит, если предыдущих не хватило. -19. **Практика Github** - - [КАК РЕШИТЬ любую ПРОБЛЕМУ связанную с OPENSOURCE](https://www.youtube.com/live/6U09wLPorYw) - - [Как искать информацию на Github и алгоритм решения неработающих плагинов VS CODE/Cursor](https://www.youtube.com/watch?v=-aCdtZ8qL24) - -### ПОЗДРАВЛЯЮ! ВЫ ГОТОВЫ К ОБУЧЕНИЮ, Сообщите в [чат](https://t.me/c/1937296927/4496) что сделали intro и я задам вам домашнюю работу. - ---- - -1. ### **update branch** - - Если в чате GitHub вас просят "обновите ветки/update branch", создайте пулреквест из ветки `main` в вашу ветку. Используйте [страницу сравнения](https://github.com/SENATOROVAI/Data-Science-For-Beginners-from-scratch-SENATOROV/compare), чтобы выбрать вашу ветку и инициировать пулреквест. - ![изображение](https://github.com/user-attachments/assets/af405a89-cbe5-4bca-b58e-4a332536e001) - - Скролим в самый низ и нажимаем зелёную кнопку "merge" - - Если возникает конфликт при слиянии - ![изображение](https://github.com/user-attachments/assets/9253262b-f940-47f5-bda9-510ef3a59b6f) - - Нажимаем Resolve - - Устраняем конфликт вручную, путём вырезания ненужных строк - Example - - Нажимаем Mark as resolved - ![изображение](https://github.com/user-attachments/assets/95875526-f125-47c9-91d5-8e9f39ed4dce) - ---- - -2. **Сложный конфликт** - -Screenshot 2024-11-28 at 1 21 12 AM - -### Commit (Переходим в курсор и жмём на клиент гита) - -Screenshot 2024-11-28 at 1 21 12 AM - -- Затрекайте свои временные изменения в коммит, нажмите "+" чтобы внести изменения в трекинг систему гит -- Список Changes должен быть пустым -- Дополнительно можете ещё раз убедиться что всё готово к слиянию веток, введите в терминал:``git status``, список файлов должен быть зелёный -Screenshot 2024-11-29 at 11 29 54 PM -Screenshot 2024-11-29 at 11 41 12 PM - -- чтобы сделать пустую строку между тайтл и дескрипшен жмём shift+enter, если в коммите участвуют системные файлы, которые я добавил, значит пишете, "update system files", Отправляем коммит нажатием на кнопку **commit&sync**, и потом делаем merge веток - -Example - -- Внизу слева, должна быть написана **ваша ветка, которую вы создали** -- Нажимаем 3 точки, merge - -![изображение](https://github.com/user-attachments/assets/43b1620f-86c6-4679-a4b7-e37d31eeeba4) - -- выбираем из какой ветки будем мержиться, нажимаем на **"origin/main remote branch"**, то есть с той ветки которая лежит на сайте гитхаб, а не ,main которая у вас на компе, поздравляю, вы успешно обновили ветку, но иногда надо устранять конфликты вручную, поэтому если это ваш случай, читайте дальше доку. - -![изображение](https://github.com/user-attachments/assets/89b59451-31e2-4f5a-8333-c7e093cf304f) - -- Нажимаем accept current change , это то что пришло с гитхаба, наши локальные данные удаляться. - -![изображение](https://github.com/user-attachments/assets/ca29e057-fd1b-4b99-b66b-6ac9e5c2bd8e) - -![изображение](https://github.com/user-attachments/assets/49afd7e8-d965-47a9-9254-10b76816bb6e) - -- отдаём коммит, ВЫ УСПЕШНО РЕШИЛИ КОНФЛИКТ И ОБНОВИЛИ ВЕТКУ! - ---- - -### Дальнейшее обучение и портфолио -- [Портфолио](https://youtu.be/CQ3J2nCkBSo?si=Sy8wc6IWHDahz3KY) - -- Все дальнейшее обучение и вклад будут осуществляться в этом репозитории. - -Следуя этим структурированным шагам, вы сможете обеспечить гладкий процесс внесения изменений и оставаться в соответствии с руководящими принципами репозитория. - - -Если у вас есть вопросы или нужна дополнительная помощь, не стесняйтесь спрашивать!