Робота з помилками

Python — це розвинута мова програмування, яка заслужила репутацію стабільної. Щоб зберегти цю репутацію, розробники хотіли б знати про будь-які недоліки, які ви знайдете в Python.

Іноді швидше виправити помилки самостійно та внести виправлення в Python, оскільки це спрощує процес і залучає менше людей. Прочитайте як зробити внесок.

Помилки в документації

Якщо ви знайшли помилку в цій документації або бажаєте запропонувати покращення, надішліть звіт про помилку на трекер. Якщо у вас є пропозиції щодо того, як це виправити, також додайте їх у звіт.

Ви також можете відкрити тему для обговорення на нашому Documentation Discourse forum.

Якщо ви знайдете помилку в темі (HTML / CSS / JavaScript) документації, будь ласка, подайте звіт про помилку в системі відстеження помилок python-doc-theme.

Якщо у вас мало часу, ви також можете надіслати звіт про помилки в документації електронною поштою на адресу docs@python.org (поведінкові помилки можна надіслати на адресу python-list@python.org). „docs@“ — це список розсилки, який ведуть волонтери; ваш запит буде занотовано, хоча і обробка може зайняти деякий час.

Дивись також

Помилки в документації - Documentation bugs

Список помилок в документації, які були надіслані до трекера помилок Python.

Трекер помилок

Огляд процесу інформування щодо покращення на трекері.

Допомога з документацією

Вичерпний посібник для осіб, що зацікавлені у внесенні змін в документацію Python.

Переклади документації

Список сторінок GitHub для перекладу документації та їхні основні контакти.

Використання трекеру помилок Python

Звіти про проблеми для самого Python слід надсилати через засіб відстеження проблем GitHub (https://github.com/python/cpython/issues). Відстеження проблем GitHub пропонує веб-форму, яка дозволяє вводити відповідну інформацію та надсилати її розробникам.

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

Якщо проблема, про яку ви повідомляєте, ще немає у списку, увійдіть на GitHub. Якщо у вас ще немає облікового запису GitHub, створіть новий обліковий запис за допомогою посилання «Sign up». Неможливо подати звіт про помилку анонімно.

Увійшовши в систему, ви можете надіслати проблему. Натисніть кнопку «New issue» на верхній панелі, щоб повідомити про нову проблему.

Форма подання має два поля «Title» та «Comment».

У полі «Назва» введіть дуже короткий опис проблеми; достатньо менше десяти слів.

У полі «Comment» детально опишіть проблему, включно з тим, що ви очікували статися і що сталося. Обов’язково вкажіть, чи були задіяні якісь модулі розширення, а також яку апаратну та програмну платформу ви використовували (включно з інформацією про версію, якщо це необхідно).

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

Дивись також

Як ефективно повідомляти про помилки

Стаття, в якій детально описано, як створити корисний звіт про помилку. Вона описує, яка інформація є корисною та чому вона корисна.

Правила опису помилок

Інформація про написання хорошого звіту про помилку. Дещо з цього стосується лише проєкту Mozilla, але взагалом описані загальні хороші практики.

Початок власного внеску в Python

Окрім повідомлення про знайдені помилки, ви також можете виправлення їх самостійно. Ви можете знайти більше інформації про те, як почати виправляти Python, у посібнику Python Developer’s Guide. Якщо у вас є запитання, core-mentorship mailing list — це дружнє місце, де можна отримати відповіді на будь-які питання, що стосуються процесу вирішення проблем у Python.