Як повідомити про помилку в Gaphor

Якщо ви коли-небудь писали рядок коду, то знатимете, що в усіх програмах є помилки. Так буде і з Гафором. Якщо ви вважаєте, що знайшли помилку, просто клацніть посилання нижче (вам потрібно мати обліковий запис на GitHub), а потім натисніть зелену кнопку «Новий випуск» у верхньому правому куті сторінки:

Повідомити про помилку в Gaphor

Коли ви створюєте новий випуск, йому буде надано номер, а розробники-волонтери, які пишуть і обслуговують код, отримають повідомлення електронною поштою. Вони можуть анотувати запитання до вашої проблеми, якщо щось незрозуміло. Вони можуть негайно закрити його та позначити як «дублікат» (хтось інший уже повідомив про помилку — і вони посилатимуться на оригінальну проблему). Іноді вони закривають помилку та кажуть «не виправлять», тому що вони не погоджуються, що це помилка або це занадто тривіально, щоб інвестувати будь-коли.

Зазвичай існує два типи помилок:

  • Технічна: у коді міститься помилка, через яку програма не працює.
  • Поведінковий: код працює правильно, але виконує неправильні дії.

В обох випадках, щоб ми могли виправити помилку, нам потрібно якомога більше інформації. Коли ви створюєте нову проблему, ви повинні спробувати включити, де це необхідно, такі види інформації:

  • Те, що ти намагався зробити,
  • Які кроки ви зробили, щоб це сталося,
  • Те, що ти очікував, станеться,
  • Що насправді сталося,
  • Чому ця різниця проблематична (це може бути не помилка!),
  • Технічні деталі, як-от версія Gaphor, яку ви використовуєте, версія вашої ОС та інші аспекти контексту, у якому працював Gaphor.

Використовуйте зрозумілу та просту мову, щоб описати проблему та, якщо це допоможе, розбийте її на кроки, щоб розробники могли легко відтворити проблему. Будь ласка, не припускайте, що ми зрозуміємо, чого ви намагаєтеся досягти. Чесно кажучи, найкраще уявити, що ми (розробники) — це купа розумних 5-річних дітей. Спробуйте пояснити все про проблему і не думайте, що ми знаємо, що ви маєте на увазі. Ми не будемо проти!

Якщо ви хочете взяти активну участь у розробці Gaphor, ми будемо раді вітати вас через веб-сайт розробника Gaphor.