Содержание страницы
Сообщение об ошибках¶Reporting Bugs
Python – зрелый язык программирования, завоевавший репутацию стабильности. Чтобы поддерживать эту репутацию, разработчики хотели бы знать обо всех недостатках, которые вы находите в Python.
Ошибки в документации¶Documentation bugs
Если вы нашли ошибку в этой документации или хотите предложить улучшение, пожалуйста, отправьте сообщение об ошибке в трекер. Если у вас есть предложение по исправлению, укажите его.
Если у вас мало времени, вы также можете отправить отчет об ошибке по электронной почте на docs@python.org. ‘docs@’ – это список рассылки, управляемый волонтерами; ваше обращение будет замечено, хотя его обработка может занять некоторое время.
См. также
Ошибки в документации на трекере задач Python
Использование трекера ошибок Python¶Using the Python issue tracker
Отчёты об ошибках в самом Python следует отправлять через Python Bug Tracker (http://bugs.python.org/). Трекер ошибок предоставляет веб-форму, позволяющую ввести соответствующие данные и отправить их разработчикам.
Первым шагом при отправке отчёта является проверка, не сообщалось ли уже об этой проблеме. Преимущество этого подхода, помимо экономии времени разработчиков, в том, что вы узнаёте, что было сделано для её исправления; возможно, проблема уже исправлена в следующем выпуске, или требуются дополнительные сведения (в этом случае вы можете их предоставить, если сможете!). Чтобы это сделать, воспользуйтесь поиском по базе ошибок в поле поиска в верхней части страницы.
Если проблема, о которой вы сообщаете, ещё не зарегистрирована в трекере, вернитесь в Python Bug Tracker и войдите в систему. Если у вас ещё нет учётной записи в трекере, выберите ссылку «Register» или, если вы используете OpenID, один из логотипов провайдера OpenID на боковой панели. Отправить сообщение об ошибке анонимно невозможно.
Теперь, когда вы вошли в систему, вы можете отправить сообщение об ошибке. Выберите ссылку «Create New» на боковой панели, чтобы открыть форму отправки сообщения об ошибке.
Форма отправки содержит несколько полей. В поле «Title» введите очень краткое описание проблемы; хорошо, если оно будет менее десяти слов. В поле «Type» выберите тип проблемы; также выберите «Component» и «Versions», к которым относится ошибка.
В поле «Comment» подробно опишите проблему, включая то, что вы oжидали и что произошло. Обязательно укажите, были ли задействованы какие-либо модули расширения, и какую аппаратную и программную платформу вы использовали (включая информацию о версиях, если необходимо).
Каждое сообщение об ошибке будет назначено разработчику, который определит, что необходимо сделать для исправления проблемы. Вы будете получать уведомление каждый раз, когда будут выполняться действия по ошибке.
См. также
- Как эффективно сообщать об ошибках
- Статья, которая подробно описывает, как составить полезный отчёт об ошибке. В ней объясняется, какая информация полезна и почему.
- Рекомендации по написанию отчётов об ошибках
- Информация о том, как написать хороший отчёт об ошибке. Некоторые моменты относятся к проекту Mozilla, но описываются общие хорошие практики.
Начало работы над собственным вкладом в Python¶Getting started contributing to Python yourself
Вы можете не только сообщать об обнаруженных ошибках, но и отправлять исправления для их устранения. Дополнительную информацию о том, как начать вносить исправления в Python, можно найти в Python Developer’s Guide. Если у вас возникнут вопросы, список рассылки core-mentorship – это дружелюбное место, где можно получить ответы на любые вопросы, касающиеся процесса исправления ошибок в Python.