Борьба с насекомыми¶
Python - это зрелый язык программирования, завоевавший репутацию стабильного. Чтобы поддерживать эту репутацию, разработчики хотели бы знать о любых недостатках, которые вы обнаружите в Python.
Иногда бывает быстрее исправлять ошибки самостоятельно и вносить исправления в Python, поскольку это упрощает процесс и вовлекает меньше людей. Узнайте, как contribute.
Ошибки в документации¶
Если вы обнаружили ошибку в этой документации или хотите предложить улучшение, пожалуйста, отправьте сообщение об ошибке на tracker. Если у вас есть предложение о том, как исправить ошибку, также укажите его.
Если у вас мало времени, вы также можете отправлять сообщения об ошибках в документации по адресу docs@python.org (сообщения об ошибках в поведении можно отправлять по адресу python-list@python.org). Список рассылки „docs@“ ведется добровольцами; ваш запрос будет замечен, хотя его обработка может занять некоторое время.
См.также
- Documentation bugs
Список ошибок в документации, которые были отправлены на трекер проблем Python.
- Issue Tracking
Обзор процесса, связанного с сообщением об улучшении на трекере.
- Helping with Documentation
Исчерпывающее руководство для тех, кто заинтересован во внесении вклада в документацию по Python.
- Documentation Translations
Список страниц GitHub для перевода документации и их основные контакты.
Использование трекера проблем Python¶
Сообщения о проблемах самого Python следует отправлять через трекер проблем GitHub (https://github.com/python/cpython/issues). Трекер проблем GitHub предлагает веб-форму, в которую можно ввести необходимую информацию и отправить ее разработчикам.
Первым шагом при подаче отчета является определение того, сообщалось ли уже об этой проблеме. Помимо экономии времени разработчиков, вы узнаете, что было сделано для ее устранения; возможно, проблема уже исправлена в следующем релизе, или требуется дополнительная информация (в этом случае вы можете предоставить ее, если сможете!). Для этого воспользуйтесь поиском по трекеру, используя поисковую строку в верхней части страницы.
Если проблемы, о которой вы сообщаете, еще нет в списке, войдите в GitHub. Если у вас еще нет учетной записи на GitHub, создайте новую учетную запись, используя ссылку «Зарегистрироваться». Невозможно отправить сообщение об ошибке анонимно.
Теперь, войдя в систему, вы можете отправить сообщение о проблеме. Нажмите на кнопку «Новый вопрос» в верхней панели, чтобы сообщить о новом вопросе.
Форма отправки имеет два поля, «Заголовок» и «Комментарий».
В поле «Заголовок» введите очень краткое описание проблемы; лучше всего - менее десяти слов.
В поле «Комментарий» подробно опишите проблему, включая то, чего вы ожидали и что произошло. Обязательно укажите, были ли задействованы какие-либо модули расширения, и какую аппаратную и программную платформу вы использовали (включая информацию о версии, если необходимо).
Каждый отчет о проблеме будет рассмотрен разработчиком, который определит, что необходимо сделать для устранения проблемы. Вы будете получать обновления каждый раз, когда будут предприняты действия по решению проблемы.
См.также
- How to Report Bugs Effectively
Статья, в которой подробно рассказывается о том, как создать полезное сообщение об ошибке. Здесь описывается, какая информация является полезной и почему она полезна.
- Bug Writing Guidelines
Информация о том, как написать хорошее сообщение об ошибке. Некоторые из этих сведений относятся к проекту Mozilla, но описываются и общие примеры хорошей практики.
Начало самостоятельного внесения вклада в Python¶
Помимо простого сообщения об обнаруженных ошибках, вы также можете присылать исправления для их устранения. Более подробную информацию о том, как приступить к созданию патчей для Python, вы можете найти в разделе Python Developer’s Guide. Если у вас есть вопросы, core-mentorship mailing list - это дружественное место, где вы можете получить ответы на все вопросы, касающиеся процесса исправления проблем в Python.