bugs.md

1> **Источник:** https://python-all.ru/3.4/bugs.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Сообщение об ошибках89Python – зрелый язык программирования, завоевавший репутацию стабильности. Чтобы поддерживать эту репутацию, разработчики хотели бы знать обо всех недостатках, которые вы находите в Python.1011## Ошибки в документации1213Если вы нашли ошибку в этой документации или хотите предложить улучшение, пожалуйста, отправьте сообщение об ошибке в [*трекер*](https://python-all.ru/3.4/bugs.html#using-the-tracker). Если у вас есть предложение по исправлению, укажите его.1415Если у вас мало времени, вы также можете отправить отчет об ошибке по электронной почте на [docs@python.org](https://python-all.ru/3.4/bugs.html). ‘docs@’ – это список рассылки, управляемый волонтерами; ваше обращение будет замечено, хотя его обработка может занять некоторое время.1617> **См. также**18>19> [Ошибки в документации](https://python-all.ru/3.4/bugs.html) на трекере задач Python2021## Использование трекера ошибок Python2223Сообщения об ошибках в сам Python следует отправлять через Python Bug Tracker ([https://bugs.python.org/](https://python-all.ru/3.4/bugs.html)). Трекер предлагает веб-форму, позволяющую ввести и отправить разработчикам необходимую информацию.2425Первым шагом при отправке отчёта является проверка, не сообщалось ли уже об этой проблеме. Преимущество этого подхода, помимо экономии времени разработчиков, в том, что вы узнаёте, что было сделано для её исправления; возможно, проблема уже исправлена в следующем выпуске, или требуются дополнительные сведения (в этом случае вы можете их предоставить, если сможете!). Чтобы это сделать, воспользуйтесь поиском по базе ошибок в поле поиска в верхней части страницы.2627Если проблема, о которой вы сообщаете, ещё не зарегистрирована в трекере, вернитесь в Python Bug Tracker и войдите в систему. Если у вас ещё нет учётной записи в трекере, выберите ссылку «Register» или, если вы используете OpenID, один из логотипов провайдера OpenID на боковой панели. Отправить сообщение об ошибке анонимно невозможно.2829Теперь, когда вы вошли в систему, вы можете отправить сообщение об ошибке. Выберите ссылку «Create New» на боковой панели, чтобы открыть форму отправки сообщения об ошибке.3031Форма отправки содержит несколько полей. В поле «Title» введите *очень* краткое описание проблемы; хорошо, если оно будет менее десяти слов. В поле «Type» выберите тип проблемы; также выберите «Component» и «Versions», к которым относится ошибка.3233В поле «Comment» подробно опишите проблему, включая то, что вы oжидали и что произошло. Обязательно укажите, были ли задействованы какие-либо модули расширения, и какую аппаратную и программную платформу вы использовали (включая информацию о версиях, если необходимо).3435Каждое сообщение об ошибке будет назначено разработчику, который определит, что необходимо сделать для исправления проблемы. Вы будете получать уведомление каждый раз, когда будут выполняться действия по ошибке.3637> **См. также**38>39> **[Как эффективно сообщать об ошибках](https://python-all.ru/3.4/bugs.html)**40>41> Статья, которая подробно описывает, как составить полезный отчёт об ошибке. В ней объясняется, какая информация полезна и почему.42>43> **[Рекомендации по написанию отчётов об ошибках](https://python-all.ru/3.4/bugs.html)**44>45> Информация о том, как написать хороший отчёт об ошибке. Некоторые моменты относятся к проекту Mozilla, но описываются общие хорошие практики.4647## Начало работы над собственным вкладом в Python4849Вы можете не только сообщать об обнаруженных ошибках, но и отправлять исправления для их устранения. Дополнительную информацию о том, как начать вносить исправления в Python, можно найти в [Python Developer’s Guide](https://python-all.ru/3.4/devguide/index.html). Если у вас возникнут вопросы, [список рассылки core-mentorship](https://python-all.ru/3.4/bugs.html) – это дружелюбное место, где можно получить ответы на любые вопросы, касающиеся процесса исправления ошибок в Python.50