bugs.md

1> **Источник:** https://python-all.ru/3.14/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.14/bugs.html#contributing-to-python).1213## Ошибки в документации1415Если вы нашли ошибку в этой документации или хотите предложить улучшение, пожалуйста, отправьте отчёт об ошибке в [трекер ошибок](https://python-all.ru/3.14/bugs.html#using-the-tracker). Если у вас есть предложение по её исправлению, укажите его тоже.1617Вы также можете открыть обсуждение на нашем [форуме Documentation Discourse](https://python-all.ru/3.14/bugs.html).1819Если вы нашли ошибку в теме оформления (HTML / CSS / JavaScript) документации, пожалуйста, отправьте отчёт об ошибке в [трекер ошибок python-doc-theme](https://python-all.ru/3.14/bugs.html).2021> **См. также**22>23> **[Ошибки в документации](https://python-all.ru/3.14/bugs.html)**24>25> Список ошибок в документации, которые были отправлены в трекер ошибок Python.26>27> **[Отслеживание ошибок](https://python-all.ru/3.14/bugs.html)**28>29> Обзор процесса, связанного с сообщением об улучшении в трекере.30>31> **[Помощь с документацией](https://python-all.ru/3.14/bugs.html)**32>33> Исчерпывающее руководство для желающих внести вклад в документацию Python.34>35> **[Переводы документации](https://python-all.ru/3.14/bugs.html)**36>37> Список страниц GitHub для перевода документации и их контактные лица.3839## Использование трекера ошибок Python4041Отчёты об ошибках для самого Python следует отправлять через трекер ошибок GitHub ([https://github.com/python/cpython/issues](https://python-all.ru/3.14/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.14/bugs.html)**60>61> Статья, которая подробно описывает, как составить полезный отчёт об ошибке. В ней объясняется, какая информация полезна и почему.62>63> **[Рекомендации по написанию отчётов об ошибках](https://python-all.ru/3.14/bugs.html)**64>65> Информация о том, как написать хороший отчёт об ошибке. Некоторые моменты относятся к проекту Mozilla, но описываются общие хорошие практики.6667## Начало работы над собственным вкладом в Python6869Вы можете не только сообщать об обнаруженных ошибках, но и отправлять исправления для их устранения. Дополнительную информацию о том, как начать вносить исправления в Python, можно найти в [Python Developer’s Guide](https://python-all.ru/3.14/bugs.html). Если у вас возникнут вопросы, [список рассылки core-mentorship](https://python-all.ru/3.14/bugs.html) – это дружелюбное место, где можно получить ответы на любые вопросы, касающиеся процесса исправления ошибок в Python.70