Обработка ошибок

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

Иногда быстрее исправить ошибки самостоятельно и внести исправления в Python, так как это упрощает процесс и вовлекает меньше людей. Узнайте, как внесут свой вклад.

Ошибки в документации

Если вы обнаружили ошибку в этой документации или хотите предложить улучшение, отправьте отчет об ошибке на следите. Если у вас есть предложение, как это исправить, включите его также.

Если у вас мало времени, вы также можете отправить отчеты об ошибках в документации по электронной почте на адрес docs@python.org (отчеты об ошибках поведения можно отправлять на python-list@python.org). 'docs@' — это список рассылки, управляемый волонтерами; ваш запрос будет замечен, хотя его обработка может занять некоторое время.

См. также

Ошибки в документации: Список ошибок в документации, которые были отправлены в отслеживатель проблем Python.
Отслеживание проблем: Обзор процесса, связанного с отправкой отчета об улучшении на следите.
Помощь в документации: Полноценное руководство для тех, кто заинтересован в участии в разработке документации Python.

Использование системы отслеживания проблем Python

Отчеты о проблемах для самого Python должны быть отправлены через систему отслеживания проблем GitHub (https://github.com/python/cpython/issues). Система отслеживания проблем GitHub предоставляет веб-форму, которая позволяет ввести и отправить необходимую информацию разработчикам.

Первый шаг при подаче отчета — определить, уже ли сообщалась о данной проблеме. Преимущество этого, помимо экономии времени разработчиков, заключается в том, что вы узнаете, что было сделано для ее исправления; возможно, проблема уже была исправлена для следующего выпуска, или требуется дополнительная информация (в таком случае вы можете предоставить ее, если можете!). Для этого воспользуйтесь поиском в системе отслеживания с помощью поисковой строки в верхней части страницы.

Если проблема, о которой вы сообщаете, еще не внесена в список, войдите в GitHub. Если у вас еще нет учетной записи GitHub, создайте новую учетную запись, используя ссылку «Регистрация».

Анонимная отправка отчета об ошибках невозможна.

После входа в систему вы можете отправить проблему. Нажмите кнопку «Создать проблему» в верхней строке, чтобы сообщить о новой проблеме.

Форма отправки содержит два поля: «Заголовок» и «Комментарий».

В поле «Заголовок» введите краткое описание проблемы; менее десяти слов — хорошо.

В поле «Комментарий» подробно опишите проблему, включая то, что вы ожидали увидеть, и то, что произошло на самом деле. Укажите, участвовали ли какие-либо модули расширения, а также используемую вами аппаратную и программную платформу (включая соответствующую информацию о версиях).

Каждый отчет о проблеме будет рассмотрен разработчиком, который определит, что необходимо сделать для исправления проблемы. Вы получите обновление каждый раз, когда будут предприняты действия по проблеме.

См. также

Как эффективно сообщать об ошибках: Статья, в которой подробно рассказывается о том, как создать полезный отчет об ошибке. Она описывает, какой вид информации полезен и почему.
Руководство по написанию отчетов об ошибках: Информация о написании хорошего отчета об ошибке. Некоторые рекомендации специфичны для проекта Mozilla, но описывают общие лучшие практики.

Начало работы с внесением вклада в Python

Помимо сообщения об обнаруженных ошибках, вы также можете отправить исправления для их исправления. Более подробную информацию о том, как начать вносить исправления в Python, можно найти в Руководстве разработчика Python. Если у вас есть вопросы, список рассылки core-mentorship — это дружелюбное место для получения ответов на все вопросы, касающиеся процесса исправления проблем в Python.