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

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

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

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

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

Вы также можете открыть обсуждение в нашем форуме Discourse по документации.

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

См. также

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

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

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

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

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

Анонимно отправить отчёт об ошибке нельзя.

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

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

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

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

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

См. также

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

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

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