bugs.md

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