Нові правила внеску

Якщо на цю сторінку перенаправили з автоматично закритого Issue/PR, не варто панікувати чи почуватися відкинутими. Найчастіше будь-яка виконана робота зрештою потрапить до Exercism, або проблему буде розвʼязано. Ми вітаємо внески й заохочуємо до них, але любимо спершу обговорити все на нашому форумі, перш ніж переходити до коду на GitHub. Створення теми на форумі зрушить справу з місця.

Протягом останнього року ми експериментували з обмеженням внесків від людей, які не є мейнтейнерами, щоб вивільнити час наших ключових контрибʼюторів і дати їм змогу робити суттєвіші покращення в треках. Це спрацювало досить добре. Порівняно з 2022 роком, протягом 2023 року ми побачили вдвічі більше доданих нових вправ і втричі більше створених силабусів. Зміна методики дала змогу робити значно більші внески, а також принесла нашим ключовим контрибʼюторам менше розчарувань і менше відволікань.

Однак я також усвідомлюю, що це створило розчарування для нових контрибʼюторів, які готові допомагати, але відчувають, що процес внесків їх стримує. Тож сьогодні я хочу запропонувати нові (або уточнені) настанови щодо того, як ми будемо працювати з внесками протягом наступних кількох місяців.

Основне правило, яке варто засвоїти: ідеї, bug та issue ми обговорюємо на нашому форумі, а відповідні зміни в коді - на GitHub (під час ревʼю PR). Друге правило: (за винятком мейнтейнерів, які діють автономно) ми спершу обговорюємо, а вже потім робимо. Наш форум дає змогу контрибʼюторам і мейнтейнерам різних треків ділитися знаннями та досвідом щодо найрізноманітніших мов та ідей, не підписуючись на 300 різних репозиторіїв на GitHub і не перевантажуючи свої сповіщення.

Оновлені настанови

Отримання підтримки

• Якщо щось не виходить ще до того, як вправу розвʼязано (наприклад, не вдається встановити CLI, запустити тести, незрозуміла логіка чи вимоги вправи), для підтримки ми використовуємо категорію «Exercism Support» на форумі та канал #get-help на нашому сервері Discord.
• Ми не використовуємо GitHub чи електронну пошту для запитів про підтримку.
• Якщо вправу вже розвʼязано, але залишилися запитання щодо неї, варто звернутися по наставництво на самому Exercism.

Повідомлення про bug та issue

• Усі bug та issue варто відкривати на нашому форумі, де широке коло людей може допомогти зрозуміти й розвʼязати проблему.
  • Якщо йдеться про мову, скористайтеся відповідною категорією Programming/xxx.
  • Якщо це bug на сайті, скористайтеся категорією «Bugs & Feature Requests».
• issue на GitHub зазвичай закриватимуться автоматично, а автора перенаправлятимуть на форум (із посиланням в один клік, щоб скопіювати й вставити свій issue, як це відбувається зараз).
• Мейнтейнери треку можуть вимкнути автозакриття issue, але офіційний шлях усе одно пролягає через форум.

Відкриття PR

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

Підсумок

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

Мені не терпиться побачити, як ці зміни вплинуть на внески протягом наступних кількох місяців. Ми знову все переглянемо в середині 2024 року.