bugs.md

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