Как внести свой вклад¶
Быстрый чек-лист¶
- Сделать форк репозитория
- Клонировать репозиторий
- Создать новую ветку
- Обеспечить совместимость со sklearn
- Написать или обновить документацию с примерами использования
- Проверить документацию с помощью serve
- Написать юнит-тесты
- Запустить тесты, чтобы убедиться, что все работает
- Закоммитить свои изменения
- Отправить свою ветку
- Открыть pull request
Руководство по участию¶
Мы приветствуем вклад в проект. Чтобы внести свой вклад, пожалуйста, следуйте этим шагам:
-
Клонирование репозитория
- Сделайте форк репозитория в свой аккаунт на GitHub.
- Клонируйте свой форкнутый репозиторий на локальную машину с помощью следующей команды:
- Перейдите в директорию проекта:
-
Создание ветки
- Создайте новую ветку для вашей фичи или исправления бага:
-
Поддержание совместимости со sklearn
- Убедитесь, что ваши изменения совместимы с
scikit-learn
, где это применимо. Это включает в себя соблюдение их конвенций, наследование их классов и обеспечение совместимости.
- Убедитесь, что ваши изменения совместимы с
-
Написание документации с примером использования
- Мы используем
mkdocs
для документации. Добавьте или обновите документацию в директорииdocs
. - Включите примеры использования, чтобы продемонстрировать, как использовать вашу фичу или изменения.
- Для предварительного просмотра документации локально выполните:
- Мы используем
-
Написание юнит-тестов
- Напишите юнит-тесты для вашего кода, чтобы обеспечить его корректность.
- Разместите ваши тесты в директории
tests
. - Запустите тесты, чтобы убедиться, что все работает:
-
Отправка ваших изменений
- Закоммитьте свои изменения с описательным сообщением коммита:
- Отправьте свою ветку в ваш форкнутый репозиторий:
- Откройте pull request в оригинальном репозитории и предоставьте подробное описание ваших изменений.
Спасибо за ваш вклад!