Поделиться через

Хактоберфест и другие хак-a-thon события

Хактоберфест является ежегодным событием по всему миру, которое проводится в октябре. Это событие поощряет разработчиков с открытым кодом вносить вклад в репозитории с помощью запросов на вытягивание (PR). GitHub размещает множество репозиториев с открытым исходным кодом, которые способствуют содержимому Microsoft Learn. Несколько репозиториев активно участвуют в Hacktoberfest.

Как внести свой вклад

Прежде чем вы сможете внести свой вклад в репозиторий с открытым исходным кодом, необходимо сначала настроить учетную запись для участия в Microsoft Learn. Если вы не знакомы с этим процессом, начните с регистрации для учетной записи GitHub. Не забудьте установить Git и средства Markdown.

Чтобы получить зачет за участие, зарегистрируйтесь на Hacktoberfest и ознакомьтесь с руководством по участию.

Поиск репозитория, который нуждается в вашей помощи

Команда PowerShell-Docs поддерживает вклад Hacktoberfest для нескольких репозиториев документации PowerShell. Мы определили набор простых задач по очистке, предназначенных для участников, вносящих вклад впервые. Полные сведения можно найти в мета-вопросе Хактоберфеста.

Для успешного выполнения этих задач необходимо выполнить следующие действия.

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

Ожидания качества

Чтобы получить успешный вклад в репозиторий Microsoft Learn с открытым исходным кодом, создайте значимый и эффективный PR. Следующие примеры с официального сайта Hacktoberfest рассматриваются как низкокачественные вклады:

  • PR, в которых содержатся массовые автоматизированные изменения
    • Пример: скрипты PR для удаления пробелов, исправления распространенных орфографических выражений или оптимизации изображений
    • Отправьте запрос, сначала описав автоматические изменения, которые вы хотите внести.
  • PRs считаются деструктивными (например, захватывая чужую ветку или коммиты и делая PR)
  • PRs рассматриваются как помеха, а не помощь.
  • PRs, которые явно пытаются увеличить число PR за октябрь

Открыть PR

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

  • PR создает ценность.
  • Участник открыт к обратной связи.
  • Предполагаемые изменения хорошо сформулируются.
  • Изменения связаны с существующей проблемой.

Если вы предлагаете pr без соответствующей проблемы, сначала создайте проблему. Для получения дополнительной информации см. GitHub: о pull request'ах.

См. также