Нові розробники/Поради щодо спілкування
Outdated translations are marked like this.
Користуйтесь цими підказками, щоб спілкуватися ефективно й отримувати допомогу від членів спільноти.
Ефективно користуйтесь завданнями на Фабрикаторі
Коли ви плануєте працювати над завданням на Фабрикаторі:
- Не треба питати дозволу: Ви можете працювати над нікому не призначеними завданнями без того, щоб вам хтось їх призначав. Немає вищого інстанції, яка призначає завдання або в якої треба спершу спитати.
- Якщо у завдання є свіжий патч у Gerrit, краще виберіть інше завдання для роботи.
- Якщо наявний патч у Gerrit не об'єднаний і вже давно не бачив ніяких змін, ви можете покращити цей наявний патч на основі відгуків на Gerrit і в завданні.
- Проведіть своє дослідження: Коли ви роздумуєте над тим, щоб почати працювати над завданням, проведіть дослідження, перш ніж починати писати код. Погляньте на код, спробуйте зрозуміти, що він має робити, почитайте пов'язану документацію і спробуйте знайти місця, де вам треба буде зробити зміни коду.
- У завданні на Фабрикатор і, скористайтеся тегами проєктів на бічній панелі, щоб знайти репозиторій коду для цього завдання.
- Якщо ви взагалі не маєте уявлення, як виправити баг, спробуйте знайти собі легше завдання.
- Вам не треба оголошувати свої плани, перш ніж починати працювати над завданням, але варто прокомунікувати той факт, що ви над завданням працюєте.
- Коли ви починаєте працювати, вкажіть себе як виконавця, натиснувши Редагувати завдання… на Фабрикаторі і вказавши своє ім'я користувача на Фабрикаторі у полі Призначено. Це дасть знати іншим, що ви працюєте над завданням, щоб вони не робили ту саму роботу.
- Коли ваші плани чи інтереси змінилися: Якщо ви більше не працюєте над завданням, приберіть себе з ролі виконавця завдання. Це дасть іншим знати, що вони можуть працювати над завданням і вони не вважатимуть, що ви далі над ним працюєте.
- Дотримуйтесь етикету Фабрикатора.
- У завданнях Фабрикатора обговорюйте лише конкретні питання, що стосуються теми завдання. Не використовуйте Фабрикатор для загальних запитань на зразок як налаштувати розробницьке середовище або як вирішити проблеми з Gerrit.
Формулюйте гарні запитання
- Не просіть спитати… просто питайте!.
- Будьте чіткі вказуйте контекст: Замість спитати «Можете дати більше інформації?», «Будь ласка, спрямуйте мене» або «Скажіть, будь ласка, де мені почати?», включіть у свої запитання таку інформацію:
- Чого ви хочете досягти?
- Що ви уже пробували? Скопіюйте-вставте свої команди і їхній вивід (якщо це не задовго) замість описувати їх своїми словами.
- Що ви уже виявили, коли досліджували це питання? Включіть посилання на код, документацію чи інші матеріали, з якими ви вже ознайомилися.
- У своїй комунікації використовуйте конкретні заголовки та теми. «Чернетка пропозиції» чи «Треба допомога» — це не достатньо конкретно.
- Робіть так, щоб розмова залишалась читабельною: Коли відповідаєте у Zulip, завданнях Фабрикатора чи у списках розсилки, цитуйте лише ті частини попередніх коментарів, які стосуються вашої відповіді. Якщо ви цитуєте попередній коментар повністю, гілку стає важче читати.
Дотримуйтесь політик і найкращих практик комунікації
Перш ніж надсилати чи публікувати своє запитання:
- Почитайте і дотримайтесь кодексу поведінки для технічних просторів Вікімедіа.
- Інклюзивна мова важлива: Замість використовувати терміни, які припускають гендерну ідентичність (на зразок «хлопці», «пані» або «пане»), скористайтесь натомість іменем людини.
Запитуйте у правильному місці
- Запитуйте публічно: Не шліть приватних повідомлень, якщо тема вашої розмови не секретна. Приватні повідомлення не допоможуть іншим.
- Запитуйте й обговорюйте в найкращому місці:
- У завданнях Фабрикатора обговорюйте лише конкретні питання, що стосуються теми завдання.
- Загальні технічні запитання, на зразок як налаштувати розробницьке середовище або як вирішити проблеми з Gerrit, ставте у місцях, перелічених на сторінці Спілкування .
- Якщо ви берете участь в аутріч-програмі, тоді місцем для обговорення самих аутріч-програм є Zulip.
Будьте терплячими
Після того, як ви опублікували своє запитання:
- Не просіть людей переглянути код окремим повідомленням. Люди отримують сповіщення з Gerrit і Фабрикатора і дадуть відповідь, коли зможуть.
- Якщо вам треба відгуки і коментарі, особливо на вихідних чи під час свят, можливо, вам треба буде почекати робочого часу. У чатах на зразок IRC: якщо ніхто не відповідає, спробуйте знову в інший час; не здавайтесь просто так!
- Якщо ви не отримали відповіді навіть будучи терплячими і за якийсь час, спробуйте інші канали комунікації, які можуть бути кращим місцем, де поставити ваше запитання.