Работа с ошибками
*****************

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

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


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

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

Если ошибка или предложение по улучшению касается перевода этой
документации, отправьте отчёт в репозиторий перевода.

Вы также можете начать обсуждение на нашем форуме Documentation
Discourse.

Если вы обнаружили ошибку в теме (HTML / CSS / JavaScript)
документации, отправьте отчёт об ошибке в систему отслеживания ошибок
python-doc-theme.

См. также:

  Ошибки в документации
     Список ошибок в документации, которые были отправлены в систему
     отслеживания ошибок Python.

  Система отслеживания ошибок
     Обзор процесса отправки улучшений через трекер.

  Помощь с документацией
     Подробное руководство для тех, кто хочет внести свой вклад в
     документацию Python.

  Переводы документации
     Список страниц на Github для перевода документации и их
     координационных групп.


Использование системы отслеживания ошибок Python
================================================

Отчеты об ошибках для самого Python следует отправлять через трекер
ошибок GitHub (https://github.com/python/cpython/issues). Трекер
GitHub предлагает веб-форму, которая позволяет заполнить
соответствующую информацию и отправить её разработчикам.

Первый шаг при подаче отчета — проверить, было ли уже сообщено об этой
проблеме. Этот шаг не только помогает сэкономить время разработчикам,
но и позволяет понять, какие усилия были приложены для устранения
проблемы; возможно, проблема уже была исправлена в следующем релизе,
или требуется дополнительная информация (в этом случае, если у вас
есть возможность, пожалуйста, предоставьте её!). Для этого
воспользуйтесь поиском в трекере, используя поле поиска в верхней
части страницы.

Если вашей проблемы нет в списке, войдите в GitHub. Если у вас ещё нет
учетной записи GitHub, создайте её, перейдя по ссылке "Sign up".
Невозможно отправить отчёт об ошибке анонимно.

После входа в систему вы можете отправить отчёт об ошибке. Нажмите на
кнопку "New issue" в верхней панели, чтобы сообщить о новой проблеме.

Форма отправки содержит два поля: "Title" и "Comment".

В поле "Title" введите *очень* краткое описание проблемы; меньше
десяти слов — это хорошо.

В поле "Comment" подробно опишите проблему, включая то, что вы ожидали
и что произошло на самом деле. Обязательно укажите, были ли
задействованы какие-либо модули расширений, а также информацию о
используемом аппаратном и программном обеспечении (включая
соответствующую версию).

Каждый отчет о проблеме будет рассмотрен разработчиком, который
определит, что нужно сделать для устранения проблемы. Вы будете
получать уведомления о каждом действии по вашему отчёту.

См. также:

  Как эффективно сообщать об ошибках
     Статья, которая подробно описывает, как создать полезный отчет об
     ошибке. В ней описывается, какая информация является полезной и
     почему.

  Руководство по написанию отчетов об ошибках
     Информация о том, как написать хороший отчет об ошибке. Некоторые
     рекомендации относятся к проекту Mozilla, но описывают общие
     принципы.


Как начать вносить свой вклад в Python
======================================

Помимо отправки сообщений об обнаруженных вами ошибках, вы также
можете предложить исправления для них. Более подробную информацию о
том, как начать исправлять ошибки в Python, вы можете найти в
Руководстве разработчика Python. Если у вас возникнут вопросы, список
рассылки core-mentorship — дружелюбное место, где можно получить
ответы на любые вопросы, касающиеся процесса исправления ошибок в
Python.
