Вклад в проекты с открытым исходным кодом Ultralytics

Добро пожаловать! Мы рады, что вы решили внести свой вклад в наши Ultralytics проекты с открытым исходным кодом. Ваше участие не только поможет повысить качество наших репозиториев, но и принесет пользу всему сообществу. Это руководство содержит четкие рекомендации и лучшие практики, которые помогут вам начать работу.

Оглавление

1. Кодекс поведения
2. Вклад через Pull Requests
   • Подписание CLA
   • Google-Стиль Docstrings
   • CI-тесты GitHub Actions
3. Сообщение об ошибках
4. Лицензия
5. Заключение
6. ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ

Кодекс поведения

Чтобы создать благоприятную и инклюзивную среду для всех, все участники должны придерживаться нашего Кодекса поведения. Уважение, доброта и профессионализм лежат в основе нашего сообщества.

Вклад через Pull Requests

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

1. Форк репозитория: Начните с форка репозитория Ultralytics YOLO на свою учетную запись GitHub.

2. Создайте ветку: Создайте новую ветку в репозитории с форком с понятным, описательным именем, отражающим ваши изменения.

3. Внесите свои изменения: Убедитесь, что ваш код соответствует стилю проекта и не содержит новых ошибок или предупреждений.

4. Проверьте свои изменения: Перед отправкой протестируйте изменения локально, чтобы убедиться, что они работают так, как ожидалось, и не вызывают никаких новых проблем.

5. Зафиксируйте свои изменения: Зафиксируйте свои изменения с помощью краткого и описательного сообщения о фиксации. Если ваши изменения касаются конкретной проблемы, укажите номер проблемы в сообщении о фиксации.

6. Создайте запрос на притяжение: Отправьте запрос на исправление (pull request) из вашего форк-репозитория в основной репозиторий Ultralytics YOLO . Предоставьте четкое и подробное объяснение ваших изменений и того, как они улучшают проект.

Подписание CLA

Прежде чем мы сможем объединить ваш запрос, вы должны подписать наше Лицензионное соглашение с вкладчиком (CLA). Это юридическое соглашение гарантирует, что ваш вклад должным образом лицензирован, что позволяет проекту продолжать распространяться под лицензией AGPL-3.0 .

После отправки вашего запроса на выгрузку бот CLA проведет вас через процесс подписания. Чтобы подписать CLA, просто добавьте комментарий в свой PR, указав:

I have read the CLA Document and I sign the CLA

Google-Стиль Docstrings

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

def example_function(arg1, arg2=4):
    """
    Example function demonstrating Google-style docstrings.

    Args:
        arg1 (int): The first argument.
        arg2 (int): The second argument, with a default value of 4.

    Returns:
        (bool): True if successful, False otherwise.

    Examples:
        >>> result = example_function(1, 2)  # returns False
    """
    if arg1 == arg2:
        return True
    return False

def example_function(arg1: int, arg2: int = 4) -> bool:
    """
    Example function demonstrating Google-style docstrings.

    Args:
        arg1: The first argument.
        arg2: The second argument, with a default value of 4.

    Returns:
        True if successful, False otherwise.

    Examples:
        >>> result = example_function(1, 2)  # returns False
    """
    if arg1 == arg2:
        return True
    return False

def example_small_function(arg1: int, arg2: int = 4) -> bool:
    """Example function with a single-line docstring."""
    return arg1 == arg2

CI-тесты GitHub Actions

Все запросы на внесение изменений должны пройти тесты непрерывной интеграции (CI) GitHub Actions, прежде чем они будут объединены. Эти тесты включают в себя линтинг, модульные тесты и другие проверки, чтобы убедиться, что ваши изменения соответствуют стандартам качества проекта. Просмотрите результаты CI и решите все возникающие проблемы.

Сообщение об ошибках

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

Лицензия

Ultralytics использует GNU Affero General Public License v3.0 (AGPL-3.0 ) для своих репозиториев. Эта лицензия способствует открытости, прозрачности и совместному совершенствованию при разработке программного обеспечения. Она гарантирует, что все пользователи могут свободно использовать, изменять и распространять программное обеспечение, способствуя созданию сильного сообщества для сотрудничества и инноваций.

Мы рекомендуем всем участникам ознакомиться с условиями лицензии AGPL-3.0 , чтобы вносить эффективный и этичный вклад в сообщество Ultralytics с открытым исходным кодом.

Заключение

Благодарим вас за интерес к участию в Ultralytics проекты с открытым исходным кодом YOLO . Ваше участие очень важно для формирования будущего нашего программного обеспечения и создания энергичного сообщества инноваций и сотрудничества. Неважно, улучшаете ли вы код, сообщаете об ошибках или предлагаете новые возможности - ваш вклад неоценим.

Мы с нетерпением ждем, когда ваши идеи воплотятся в жизнь, и ценим ваше стремление развивать технологию обнаружения объектов. Давайте вместе продолжать развиваться и внедрять инновации в этом захватывающем путешествии с открытым исходным кодом. Счастливого кодинга! 🚀🌟

ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ

Почему я должен вносить свой вклад в репозитории с открытым исходным кодом Ultralytics YOLO ?

Вклад в репозитории Ultralytics YOLO с открытым исходным кодом улучшает программное обеспечение, делая его более надежным и многофункциональным для всего сообщества. Вклад может включать в себя усовершенствование кода, исправление ошибок, улучшение документации и внедрение новых функций. Кроме того, участие в проекте позволяет вам сотрудничать с другими квалифицированными разработчиками и экспертами в данной области, что повышает ваши собственные навыки и репутацию. Подробнее о том, как начать работу, читайте в разделе "Внесение вклада через Pull Requests ".

Как подписать лицензионное соглашение с разработчиком (CLA) для Ultralytics YOLO ?

Чтобы подписать Лицензионное соглашение с контрибьютором (CLA), следуйте инструкциям, предоставленным CLA-ботом после отправки запроса на исправление. Этот процесс гарантирует, что ваш вклад будет должным образом лицензирован в соответствии с лицензией AGPL-3.0 , поддерживая юридическую целостность проекта с открытым исходным кодом. Добавьте комментарий в свой запрос на исправление, указав:

I have read the CLA Document and I sign the CLA.

Дополнительные сведения см. в разделе Подписание CLA.

Что такое Google-style docstrings, и почему они требуются для Ultralytics YOLO вкладов?

Google-стиль docstrings обеспечивает четкую и лаконичную документацию для функций и классов, улучшая читаемость и сопровождаемость кода. В этих документах описывается назначение функции, ее аргументы и возвращаемые значения с соблюдением определенных правил форматирования. При внесении вклада в Ultralytics YOLO , следуя Google-стилю docstrings, вы можете быть уверены, что ваши дополнения хорошо документированы и понятны. Примеры и рекомендации можно найти в разделе Google-Style Docstrings.

Как я могу убедиться, что мои изменения прошли тесты GitHub Actions CI?

Перед тем, как ваш запрос на притяжение будет объединен, он должен пройти все тесты непрерывной интеграции (CI) GitHub Actions. Эти тесты включают в себя линтинг, модульные тесты и другие проверки, чтобы убедиться, что код соответствует

стандарты качества проекта. Просмотрите результаты CI и устраните все проблемы. Подробную информацию о процессе CI и советы по устранению неполадок можно найти в разделе Тесты CI на GitHub Actions.

Как сообщить об ошибке в репозиториях Ultralytics YOLO ?

Чтобы сообщить об ошибке, предоставьте вместе с сообщением об ошибке четкий и ясный минимальный воспроизводимый пример. Это поможет разработчикам быстро выявить и устранить проблему. Убедитесь, что ваш пример минимален, но достаточен для воспроизведения проблемы. Более подробные шаги по сообщению об ошибках приведены в разделе " Сообщение об ошибках".

📅 Создано 1 год назад ✏️ Обновлено 1 месяц назад

Комментарии