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

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.