bugs.md

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