Борьба с насекомыми

Python - это зрелый язык программирования, завоевавший репутацию стабильного. Чтобы поддерживать эту репутацию, разработчики хотели бы знать о любых недостатках, которые вы обнаружите в Python.

Иногда бывает быстрее исправлять ошибки самостоятельно и вносить исправления в Python, так как это упрощает процесс и вовлекает меньше людей. Узнайте, как contribute.

Ошибки в документации

Если вы обнаружили ошибку в этой документации или хотите предложить улучшение, пожалуйста, отправьте сообщение об ошибке на tracker. Если у вас есть предложение, как исправить ошибку, также укажите его.

Вы также можете открыть тему для обсуждения на нашем сайте Documentation Discourse forum.

Если вы обнаружили ошибку в теме (HTML / CSS / JavaScript) документации, пожалуйста, отправьте сообщение об ошибке на python-doc-theme bug 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.