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

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

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

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

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

Если у вас мало времени, вы также можете отправить отчеты об ошибках в документации по электронной почте на адрес 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.