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

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.