bugs.md

1> **Источник:** https://python-all.ru/3.9/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.9/bugs.html#contributing-to-python).1213## Ошибки в документации1415Если обнаружена ошибка в этой документации или есть предложение по улучшению, отправьте сообщение об ошибке в [трекер](https://python-all.ru/3.9/bugs.html#using-the-tracker). Если есть предложение по исправлению, включите его также.1617Если у вас мало времени, вы также можете отправить сообщение об ошибке в документации по электронной почте на адрес [docs@python.org](https://python-all.ru/3.9/bugs.html) (поведенческие ошибки можно отправлять на [python-list@python.org](https://python-all.ru/3.9/bugs.html)). 'docs@' – это список рассылки, поддерживаемый волонтёрами; ваш запрос будет замечен, хотя его обработка может занять некоторое время.1819> **См. также**20>21> **[Ошибки в документации](https://python-all.ru/3.9/bugs.html)**22>23> Список ошибок в документации, которые были отправлены в трекер ошибок Python.24>25> **[Отслеживание ошибок](https://python-all.ru/3.9/bugs.html)**26>27> Обзор процесса, связанного с сообщением об улучшении в трекере.28>29> **[Помощь с документацией](https://python-all.ru/3.9/bugs.html)**30>31> Исчерпывающее руководство для желающих внести вклад в документацию Python.32>33> **[Переводы документации](https://python-all.ru/3.9/bugs.html)**34>35> Список страниц GitHub для перевода документации и их контактные лица.3637## Использование трекера ошибок Python3839Отчёты об ошибках для самого Python следует отправлять через трекер ошибок GitHub ([https://github.com/python/cpython/issues](https://python-all.ru/3.9/bugs.html)). Трекер ошибок GitHub предоставляет веб-форму, в которую можно ввести необходимую информацию и отправить её разработчикам.4041Первый шаг при отправке отчёта – определить, не сообщалось ли уже об этой проблеме. Преимущество этого, помимо экономии времени разработчиков, в том, что вы узнаете, что было сделано для её исправления; возможно, проблема уже исправлена в следующем релизе, или требуется дополнительная информация (в этом случае вы можете её предоставить, если сможете!). Для этого выполните поиск в трекере с помощью поля поиска в верхней части страницы.4243Если проблема, о которой вы сообщаете, ещё не в списке, войдите в GitHub. Если у вас ещё нет учётной записи GitHub, создайте новую с помощью ссылки «Sign up». Невозможно отправить отчёт об ошибке анонимно.4445Войдя в систему, вы можете отправить ошибку. Нажмите кнопку «New issue» в верхней панели, чтобы сообщить о новой ошибке.4647Форма отправки содержит два поля: «Title» и «Comment».4849В поле «Title» введите *очень* краткое описание проблемы; меньше десяти слов – хорошо.5051В поле «Comment» подробно опишите проблему, включая то, что вы oжидали и что произошло. Обязательно укажите, были ли задействованы какие-либо модули расширения, и какую аппаратную и программную платформу вы использовали (включая информацию о версиях, если необходимо).5253Каждый отчёт об ошибке будет рассмотрен разработчиком, который определит, что необходимо сделать для её исправления. Вы будете получать уведомления каждый раз, когда по ошибке предпринимается действие.5455> **См. также**56>57> **[Как эффективно сообщать об ошибках](https://python-all.ru/3.9/bugs.html)**58>59> Статья, которая подробно описывает, как составить полезный отчёт об ошибке. В ней объясняется, какая информация полезна и почему.60>61> **[Рекомендации по написанию отчётов об ошибках](https://python-all.ru/3.9/bugs.html)**62>63> Информация о том, как написать хороший отчёт об ошибке. Некоторые моменты относятся к проекту Mozilla, но описываются общие хорошие практики.6465## Начало работы над собственным вкладом в Python6667Вы можете не только сообщать об обнаруженных ошибках, но и отправлять исправления для их устранения. Дополнительную информацию о том, как начать вносить исправления в Python, можно найти в [Python Developer’s Guide](https://python-all.ru/3.9/bugs.html). Если у вас возникнут вопросы, [список рассылки core-mentorship](https://python-all.ru/3.9/bugs.html) – это дружелюбное место, где можно получить ответы на любые вопросы, касающиеся процесса исправления ошибок в Python.68