Як повідомляти розробникам NVDA про проблеми та помилки? Детальна інструкція

Часто у різних спільнотах користувачі обговорюють якісь проблеми з NVDA. Обговорюють-обговорюють, але детального вирішення проблеми не знаходять. Це означає, що настав час повідомити про цю проблему розробникам. Нижче — детальна інструкція про те, як це зробити.

Повідомлення про помилки (або ж баґрепорти) розробники приймають на платформі GitHub англійською мовою. Тому перед тим, як надсилати їм цю інформацію, спершу зареєструйтеся на Github, якщо ще не маєте там облікового запису. Всі баґрепорти потрібно передавати через розділ Issues.

На цій сторінці ви знайдете два посилання для надсилання повідомлень:

• перше дозволяє вам надіслати повідомлення про помилку;
• друге дозволяє вам запропонувати розробникам свою ідею або новий функціонал.

Ми зосередимося на надсиланні баґрепортів, бо це дуже відповідальна справа, яка вимагає ретельної роботи.

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

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

Ось яка інформація є обов’язковою:

• Кроки відтворення (Steps to reproduce): детально поясніть, що саме ви робите, через що NVDA зависає або виникає інша проблема.
  Актуальна поведінка (Actual behavior): розкажіть, як поводиться NVDA за цих умов.
  Очікувана поведінка (Expected behavior): вкажіть, яку поведінку ви очікуєте від NVDA за цих умов.
  Файли журналів або дампів аварійного завершення роботи NVDA (logs, crash dumps and other attachments): надайте файли журналів NVDA та інші вкладення, які підтверджують проблему. Якщо NVDA зависла й ви її перезапустили, то старий журнал завжди знайдете за таким шляхом: C:\Users\admin\AppData\Local\Temp\nvda-old.log (замість admin має бути ім’я вашого локального облікового запису).
  Вкажіть, яку версію NVDA — переносну, встановлену чи запущену з джерельного коду — ви використовуєте.
• Вкажіть номер версії NVDA, номер версії Windows, а також назву й номер версії інших програм, з якими в NVDA виникають труднощі. В шаблоні це все різні запитання, врахуйте це.
  Вкажіть, чи зникає проблема після перезавантаження комп’ютера.
  Вкажіть, чи пробували ви інші версії NVDA, якщо так, то яка їхня поведінка в цих умовах.
• Вкажіть, чи зникає проблема, якщо вимкнути додатки.
  Вкажіть, чи допомагає інструмент виправлення реєстру COM.

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

Будьте терпеливими — запитань може бути багато.

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

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