Документация Python неофициальный перевод

Сообщение об ошибках в PythonReporting Bugs in Python

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

Отчеты об ошибках следует отправлять через трекер ошибок Python (http://bugs.python.org/). Трекер ошибок предоставляет веб-форму, которая позволяет ввести и отправить разработчикам соответствующую информацию.

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

Если сообщаемая проблема еще не зарегистрирована в трекере ошибок, вернитесь к трекеру ошибок Python. Если у вас еще нет учетной записи трекера, выберите ссылку «Register» на боковой панели и пройдите процедуру регистрации. В противном случае, если вы не вошли в систему, введите свои учетные данные и выберите «Login». Невозможно отправить отчет об ошибке анонимно.

Теперь, когда вы вошли в систему, вы можете отправить сообщение об ошибке. Выберите ссылку «Create New» на боковой панели, чтобы открыть форму отправки сообщения об ошибке.

Форма отправки содержит несколько полей. В поле «Title» введите очень краткое описание проблемы; хорошо, если оно будет менее десяти слов. В поле «Type» выберите тип проблемы; также выберите «Component» и «Versions», к которым относится ошибка.

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

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

См. также

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