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

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

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

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

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

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

Если вы обнаружите ошибку в теме (HTML/CSS/JavaScript) документации, пожалуйста, отправьте отчет об ошибке в трекер ошибок python-doc-theme.

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