Нові розробники/Поради щодо спілкування

From mediawiki.org
This page is a translated version of the page New Developers/Communication tips and the translation is 100% complete.

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

Ефективно користуйтесь завданнями на Фабрикаторі

Коли ви плануєте працювати над завданням на Фабрикаторі:

  • Не треба питати дозволу: Ви можете працювати над нікому не призначеними завданнями без того, щоб вам хтось їх призначав. Немає вищого інстанції, яка призначає завдання або в якої треба спершу спитати.
    • Якщо у завдання є свіжий патч у Gerrit, краще виберіть інше завдання для роботи.
    • Якщо наявний патч у Gerrit не об'єднаний і вже давно не бачив ніяких змін, ви можете покращити цей наявний патч на основі відгуків на Gerrit і в завданні.
  • Проведіть своє дослідження: Коли ви роздумуєте над тим, щоб почати працювати над завданням, проведіть дослідження, перш ніж починати писати код. Погляньте на код, спробуйте зрозуміти, що він має робити, почитайте пов'язану документацію і спробуйте знайти місця, де вам треба буде зробити зміни коду.
    • У завданні на Фабрикатор і, скористайтеся тегами проєктів на бічній панелі, щоб знайти репозиторій коду для цього завдання.
    • Якщо ви взагалі не маєте уявлення, як виправити баг, спробуйте знайти собі легше завдання.
  • Вам не треба оголошувати свої плани, перш ніж починати працювати над завданням, але варто прокомунікувати той факт, що ви над завданням працюєте.
    • Коли ви починаєте працювати, вкажіть себе як виконавця, натиснувши Редагувати завдання… на Фабрикаторі і вказавши своє ім'я користувача на Фабрикаторі у полі Призначено. Це дасть знати іншим, що ви працюєте над завданням, щоб вони не робили ту саму роботу.
    • Коли ваші плани чи інтереси змінилися: Якщо ви більше не працюєте над завданням, приберіть себе з ролі виконавця завдання. Це дасть іншим знати, що вони можуть працювати над завданням і вони не вважатимуть, що ви далі над ним працюєте.
  • Дотримуйтесь етикету Фабрикатора.
    • У завданнях Фабрикатора обговорюйте лише конкретні питання, що стосуються теми завдання. Не використовуйте Фабрикатор для загальних запитань на зразок як налаштувати розробницьке середовище або як вирішити проблеми з Gerrit.

Формулюйте гарні запитання

  • Не просіть спитати… просто питайте!.
  • Будьте чіткі вказуйте контекст: Замість спитати «Можете дати більше інформації?», «Будь ласка, спрямуйте мене» або «Скажіть, будь ласка, де мені почати?», включіть у свої запитання таку інформацію:
    • Чого ви хочете досягти?
    • Що ви уже пробували? Скопіюйте-вставте свої команди і їхній вивід (якщо це не задовго) замість описувати їх своїми словами.
    • Що ви уже виявили, коли досліджували це питання? Включіть посилання на код, документацію чи інші матеріали, з якими ви вже ознайомилися.
  • У своїй комунікації використовуйте конкретні заголовки та теми. «Чернетка пропозиції» чи «Треба допомога» — це не достатньо конкретно.
  • Робіть так, щоб розмова залишалась читабельною: Коли відповідаєте у Zulip, завданнях Фабрикатора чи у списках розсилки, цитуйте лише ті частини попередніх коментарів, які стосуються вашої відповіді. Якщо ви цитуєте попередній коментар повністю, гілку стає важче читати.

Дотримуйтесь політик і найкращих практик комунікації

Перш ніж надсилати чи публікувати своє запитання:

Запитуйте у правильному місці

  • Запитуйте публічно: Не шліть приватних повідомлень, якщо тема вашої розмови не секретна. Приватні повідомлення не допоможуть іншим.
  • Запитуйте й обговорюйте в найкращому місці:
    • У завданнях Фабрикатора обговорюйте лише конкретні питання, що стосуються теми завдання.
    • Загальні технічні запитання, на зразок як налаштувати розробницьке середовище або як вирішити проблеми з Gerrit, ставте у місцях, перелічених на сторінці Спілкування .
    • Якщо ви берете участь в аутріч-програмі, тоді місцем для обговорення самих аутріч-програм є Zulip.

Будьте терплячими

Після того, як ви опублікували своє запитання:

  • Не просіть людей переглянути код окремим повідомленням. Люди отримують сповіщення з Gerrit і Фабрикатора і дадуть відповідь, коли зможуть.
  • Якщо вам треба відгуки і коментарі, особливо на вихідних чи під час свят, можливо, вам треба буде почекати робочого часу. У чатах на зразок IRC: якщо ніхто не відповідає, спробуйте знову в інший час; не здавайтесь просто так!
  • Якщо ви не отримали відповіді навіть будучи терплячими і за якийсь час, спробуйте інші канали комунікації, які можуть бути кращим місцем, де поставити ваше запитання.