Repository navigation
[TASK] Контрибьютинг в Open Source (https://github.com/SENATOROVAI/intro-cs/issues/8) - #774
olehpatsan wants to merge 9 commits into
Conversation
| """Open-source quiz.""" | ||
|
|
||
| # Проект в который вы отправили пул реквест, попадает под определение опенсорса: | ||
| # | ||
| # Есть ли у него лицензия? Обычно в корне репозитория находится файл LICENSE. | ||
| # | ||
| # Ответ: Да. | ||
| # | ||
| # Напишите название понравившейся компании и ссылку на репозиторий | ||
| # | ||
| # Ответ: Google DeepMind — AlphaFold: https://github.com/google-deepmind/alphafold | ||
| # | ||
| # Проект активно принимает стороннюю помощь? | ||
| # | ||
| # Ответ: Да | ||
| # | ||
| # Напишите второе улучшение которое вы сделали | ||
| # | ||
| # Ответ: Исправил устаревшие ссылки `github.com/deepmind/alphafold` | ||
| # (ссылки на issues #10, #24, #463 возвращали 404) | ||
| # на `github.com/google-deepmind/alphafold` в `README.md`, | ||
| # `docs/technical_note_v2.3.0.md` и `pyproject.toml`. | ||
| # Первое улучшение — исправление замечания линтера B007 (неиспользуемая | ||
| # переменная цикла) в `alphafold/model/modules_multimer.py`. | ||
| # | ||
| # - Issue: https://github.com/google-deepmind/alphafold/issues/1143 | ||
| # - Pull request: https://github.com/google-deepmind/alphafold/pull/1144 | ||
| # | ||
| # Посмотрите на коммиты в основной ветке, напишите общее количество | ||
| # | ||
| # Ответ: 327. | ||
| # | ||
| # Когда был последний коммит? | ||
| # | ||
| # Ответ: 3 дня назад. | ||
| # | ||
| # Сколько контрибьюторов у проекта? | ||
| # | ||
| # Ответ: 33 контрибьютора. | ||
| # | ||
| # Как часто люди коммитят в репозиторий? (На GitHub выяснить это можно, кликнув по ссылке «Commits» в верхней панели.) | ||
| # | ||
| # Ответ: В среднем 3-5 коммитов в неделю. | ||
| # | ||
| # Сколько сейчас открытых ишью? | ||
| # | ||
| # Ответ: 122. | ||
| # | ||
| # Быстро ли мейнтейнеры реагируют на ишью после того, когда они открываются? | ||
| # | ||
| # Ответ: Да, отвечают в течение пары часов на вопросы по Issue. | ||
| # | ||
| # Ведётся ли активное обсуждение ишью? | ||
| # | ||
| # Ответ: В зависимости от ишью. Чаще просто один полный ответ от команды проекта. | ||
| # | ||
| # Есть ли недавно созданные ишью? | ||
| # | ||
| # Ответ: Да, 5 часов назад. | ||
| # | ||
| # Есть ли закрытые ишью? (На странице Issues GitHub-репозитория щелкните на вкладку «Closed», чтобы увидеть закрытые ишью.) | ||
| # | ||
| # Ответ: Да, 69 закрытых. | ||
| # | ||
| # Сколько сейчас открытых пул-реквестов? | ||
| # | ||
| # Ответ: 165 открытых и 338 закрытых. | ||
| # | ||
| # Быстро ли мейнтейнеры реагируют на пул-реквесты после их открытия? | ||
| # | ||
| # Ответ: Да, как и на Issue, дают полноценный ответ. | ||
| # | ||
| # Ведётся ли активное обсуждение пул-реквестов? | ||
| # | ||
| # Ответ: В зависимости от проблемы. Чаще нет. | ||
| # | ||
| # Есть ли недавно отправленные пул-реквесты? | ||
| # | ||
| # Ответ: Да, 5 часов назад вместе с ишью. | ||
| # | ||
| # Как давно были объединены пул-реквесты? (На странице Pull Request GitHub-репозитория щелкните на вкладку «Closed», чтобы увидеть закрытые пул-реквесты.) | ||
| # | ||
| # Ответ: Последний закрытый и смерженный pull request был неделю назад. |
ruslansenatorov
left a comment
There was a problem hiding this comment.
@olehpatsan Привет! Спасибо за работу: у ноутбуков (кроме log.ipynb) есть парные .py, ветка task/8-open-source-update и заголовок оформлены по стандарту, привязка Closes https://github.com/SENATOROVAI/intro-cs/issues/8 на месте, ответ про AlphaFold со ссылками на issue и PR содержательный. Оставил 2 построчных замечания в open_source_quiz.py. Главные проблемы сейчас в составе PR и в стандартах задания open source.
Исправьте файлы и запушьте новый коммит, отвечать на комментарии не нужно.
Оформление PR
- Состав. В PR 37 файлов и несколько разных заданий (commits, cpython, issues, stash, venv, github quiz, open source). Одна ветка = одно задание = один issue. Для этого PR оставьте только файлы задания open source (intro-cs#8). Остальные ответы вынесите в отдельные PR из своих веток.
- Общие файлы и лишнее. Уберите изменения
.gitignore(строкаSENATOROV/),.github/dependabot.yml, а такжеlog.ipynb,tests/quiz/environment.ymlиtests/quiz/requirements.txt(не относятся к заданию #8).README.mdменяется по заданию, но сейчас в нём только удалены чужие пункты благодарностей и добавлены контакты; нужна полная переработка по шаблону (см. ниже). - Коммиты. 33 коммита, среди них не в формате Conventional Commits: «Добавлен ноутбук c логом прохождения интро.», «Quiz1 and quiz2 are done!», «[TASK] Quiz #6(…)», «UPDATE README (#648)», «Update README.md», «Merge pull request #1…», «Merge pull request #2…», «merge: … quiz branch» (6 шт.). Merge-коммиты в ветке задания не нужны. Пересоберите историю от свежего
main:git rebase -i, затемgit push --force-with-lease(или создайте чистую ветку и перенесите нужные файлы). - Описание. Раздел «Changes» описывает только одну правку, а в PR 37 файлов. Опишите, что сделано и зачем, и перечислите реальный состав PR.
- Расположение. Для задания open source ноутбуки должны лежать в
docs/github/, а не вtests/quiz/. Нужныdocs/github/quiz.ipynb+quiz.pyиdocs/github/opensource.ipynb+opensource.py(сейчасgithub_quiz.*иopen_source_quiz.*). Исправить:git mv, коммитrefactor: move task notebooks to docs/github. - Нет
.py. Дляlog.ipynbнет.py. Если файл остаётся в PR, создайте пару (jupytext --to py:light log.ipynb); по смыслу его лучше убрать из этого PR.
Стандарты репозитория (задание open source, intro-cs#8)
В PR нет обязательных файлов:
- README.md. Переписать по шаблону из issue #8: один заголовок
# Название, разделы##строго в порядке «Задания → Быстрый старт → Структура репозитория → Стандарты кода → Участие в проекте → Лицензия», бейджи CI, Python, License, таблица| Задание | Issue | Файлы | Статус |со ссылкой на intro-cs#8, блокbashсgit clone,python -m venv,pre-commit install, дерево только из реально существующих папок, без метокЗАПОЛНИТЬ/ВАШ_ЛОГИН. - AUTHORS.md. Авторы (мейнтейнер курса и вы) и раздел «Благодарности». Пункты разделов «Улучшения репозитория», «Улучшения курсов», «Улучшение организации» из README базового репозитория должны дословно перейти сюда; сейчас из README удалено 5 пунктов, и их нет ни в каком AUTHORS.
- CODE_OF_CONDUCT.md. На основе Contributor Covenant (https://www.contributor-covenant.org/ru/version/2/1/code_of_conduct/) с контактом для жалоб. Путь: Insights → Community Standards → Code of conduct → Add.
- SECURITY.md. Как сообщить об уязвимости не в публичном issue и какие версии поддерживаются. Путь: Security → Security policy → Start setup.
- CHANGELOG.md. Формат Keep a Changelog (https://keepachangelog.com/ru/1.1.0/): раздел
## [X.Y.Z] - ГГГГ-ММ-ДДдля версии из rc-тега, подразделы Added / Changed / Removed / Fixed, пункты по коммитам PR. Подсказка:git cliff --tag v1.0.0 -o CHANGELOG.md. - CONTRIBUTING.md. Проверьте, что файл есть и ссылка на лицензию ведёт на
LICENSE, а не наLICENSE.md. - Коммиты (OS5). Один коммит = один файл (или пара
.ipynb+.py). - Pre-release тег. Перед закрытием выпустите аннотированный тег
v1.0.0-rc.Nна последнем коммите, создайте по нему релиз с отметкой pre-release и добавьте ссылку в описание PR.
Файлы вашего репозитория мне недоступны, поэтому наличие файлов проверено по списку изменений PR; если они есть в вашей ветке, но не попали в PR, добавьте их в эту же ветку.
Generated by Claude Code
7512a1f to
a6d9b03
Compare
|
@olehpatsan Привет! Проверил пересобранную ветку: состав PR (11 файлов задания и стандартов), расположение в Generated by Claude Code |
|
Аннотированный тег Релиз отмечен как pre-release: https://github.com/olehpatsan/Data-Science-For-Beginners-from-scratch-course/releases/tag/v1.0.0-rc.1 (ссылка есть в описании PR). Проверка: git ls-remote https://github.com/olehpatsan/Data-Science-For-Beginners-from-scratch-course 'refs/tags/v1.0.0-rc.1^{}' |
|
@olehpatsan Привет! Проверил пересобранную ветку (9 коммитов, 11 файлов). Новых замечаний нет: состав и расположение файлов в Остался один пункт, который я не могу проверить: ваш репозиторий с тегом мне недоступен. Перед закрытием убедитесь, что аннотированный тег Generated by Claude Code |
|
Тег уже на этом коммите: аннотированный тег Вывод
|
|
@olehpatsan Проверил пересобранную ветку: в PR 11 файлов задания, ноутбуки лежат в Осталась одна проверка: ваш репозиторий мне недоступен, поэтому тег Generated by Claude Code |
|
Проверил тег и релиз, всё сходится, проверка пройдена:
PR готов к закрытию. |
ruslansenatorov
left a comment
There was a problem hiding this comment.
@olehpatsan Привет! Проверил новые коммиты: PR пересобран от свежего main, в нём 11 файлов задания, ноутбуки лежат в docs/github/ с парными .py, все 9 коммитов в формате Conventional Commits по одному файлу, слияний нет. README соответствует шаблону (разделы в нужном порядке, три бейджа, таблица заданий со ссылкой на intro-cs#8, дерево из реальных папок), все 44 пункта благодарностей дословно перенесены в AUTHORS.md, CODE_OF_CONDUCT.md, SECURITY.md, CHANGELOG.md на месте, ссылка на лицензию в CONTRIBUTING.md исправлена, строки в .py не длиннее 79 символов. Тег v1.0.0-rc.1 аннотированный и указывает на текущий последний коммит. Все мои прошлые треды закрыты, новых замечаний нет.
Осталось одно, что я не могу проверить сам: открыть страницу релиза v1.0.0-rc.1 и убедиться, что на ней стоит отметка Pre-release (не Latest и не Draft). Если так, замечаний больше нет.
Generated by Claude Code
|
@olehpatsan Все замечания исправлены, закрываю PR. Спасибо за работу! Остался финальный релиз — снимок вашего main:
Generated by Claude Code |

Closes https://github.com/SENATOROVAI/intro-cs/issues/8
Что сделано и зачем
Сдача задания intro-cs#8 «Первый вклад в Open Source». Ветка пересобрана от свежего
mainосновного репозитория: в PR только файлы этого задания и обязательные файлы стандартов репозитория, по одному файлу (или паре.ipynb+.py) на коммит, все коммиты в формате Conventional Commits, merge-коммитов нет.Вклад в open source: issue google-deepmind/alphafold#1143 и pull request google-deepmind/alphafold#1144 (исправление B007 и устаревших ссылок
deepmind/alphafold, CLA подписан).Pre-release: https://github.com/olehpatsan/Data-Science-For-Beginners-from-scratch-course/releases/tag/v1.0.0-rc.1
Состав PR (11 файлов, 9 коммитов)
docs/github/images/close-pr.png: скриншот для ответа 3.2 (добавлен черезgit add -f, т.к.*.pngв.gitignore).docs/github/quiz.ipynb+quiz.py: тест по GitHub (часть 1), строки ≤ 79 символов, закрывающие тройные кавычки блока кода на отдельной строке.docs/github/opensource.ipynb+opensource.py: анализ AlphaFold (часть 3), все цифры проверены на GitHub, указаны абсолютные даты (2026-11-03).README.md: переписан по шаблону (Задания → Быстрый старт → Структура репозитория → Стандарты кода → Участие в проекте → Лицензия), бейджи CI/Python/License.AUTHORS.md: мейнтейнер курса, автор форка и благодарности: все 44 пункта разделов «Улучшения репозитория», «Улучшения курсов», «Улучшение организации» перенесены из README дословно.CODE_OF_CONDUCT.md: Contributor Covenant 2.1 (ru), контакт для жалоб через приватный GitHub-репорт.SECURITY.md: поддерживаемые версии и порядок приватного сообщения об уязвимостях.CONTRIBUTING.md: ссылка на лицензиюLICENSE.md→LICENSE.CHANGELOG.md: Keep a Changelog, раздел[1.0.0-rc.1] - 2026-11-03..gitignore,.github/dependabot.yml,log.ipynb,tests/quiz/*в PR не входят; остальные задания уже сданы отдельными PR.Как проверить
pre-commit run --filesпо файлам PR: все хуки проходят (проверено на Python 3.11)..ipynbвdocs/github/есть одноимённый.py.git log --oneline main..task/8-open-source-update: 9 коммитов, один файл или пара на коммит.