Вклад у розвиток проекту SubQuery
Вклад у розвиток проекту SubQuery
Ласкаво просимо! Ми хочемо подякувати вам за те, що ви розглянули можливість зробити свій вклад у проект SubQuery! Разом ми зможемо прокласти шлях до бiльш децентралізованого майбутнього.
::: Інформаційна замітка Ця документація активно підтримується командою SubQuery. Ми вітаємо ваші внески. Ви можете зробити це, розгалузивши наш проект на GitHub і внісши зміни в усі файли документації markdown в каталозі docs
. :::
Нижче наводиться набір рекомендацій (не правил) щодо внесення вкладу в SubQuery. Дотримання цих рекомендацій допоможе нам зробити процес внесення внесків простим і ефективним для всіх учасників. Це також означає, що ви згодні поважати час розробників, які керують і розвивають цей проєкт. У свою чергу, ми відповімо взаємністю на цю повагу, вирішивши вашу проблему, розглянувши зміни, співпрацюючи в поліпшенні і допомагаючи вам завершити ваші запити на Витяг.
Наш Кодекс Поведінки
Ми серйозно ставимося до проектів і відповідальності нашої спільноти з відкритим вихідним кодом і вимагаємо від себе та інших учасників високих стандартів спілкування. Беручи участь і вносячи свій внесок у цей проект, ви погоджуєтеся дотримуватися нашого кодексу поведінки.
Початок роботи
Внесок в наші репозиторії здійснюється через проблеми і запити на Витяг (PRS). Кілька загальних рекомендацій, які охоплюють обидва варіанти:
- Перш ніж створювати власні питання та PR, за допомогою пошука переконайтеся в тому, що вони не були створені раніше.
- Ми докладаємо всіх зусиль для того, щоб забезпечити своєчасне вирішення проблем, але, залежно від впливу даних проблем, може знадобитися більше часу на дослідження основної причини. Дружня @ згадка відправника або учасника у гілці коментарів може допомогти привернути увагу до вашої проблеми, якщо вона не вирішується.
Як зробити вклад у Проект
Звіт про знайдені помилки/баги
Помилки відстежуються як проблеми на GitHub. При реєстрації проблеми поясніть її суть і включіть додаткові відомості, які допоможуть фахівцям із супроводу відтворити проблему:
- Щоб ідентифікувати проблему, намагайтеся використовувати зрозумілу та описову назву.
- Опишіть точні кроки для вiдтворення проблеми.
- Опишіть, який результат ви отримали після виконання цих кроків.
- Поясніть, який результат ви очікували побачити замість отриманого результату, і чому.
- При можливості додавайте скріншоти.
Відправлення Pull Requests
В цілому, ми дотримуємося робочого процесу Git "fork-and-pull":
- Перенесіть репозиторій на свій обліковий запис Github.
- Клонуйте проект на свій комп'ютер.
- Створіть локальну гілку з коротким, але описовим назвою.
- Зафіксуйте зміни в гілці.
- Дотримуйтесь усіх рекомендацій щодо форматування та тестування, характерних для цього сховища.
- Внесіть зміни у свою вилку.
- Відкрийте PR у нашому сховищі.
Стандарт Оформлення Коду
Повідомлення Git Commit
- Використовуйте даний час ("Додати функцію", а не"додана функція").
- Використовуйте наказовий спосіб ("Перемістити курсор на..." не "Переміщує курсор на...").
- Обмежте перший рядок 72 символами або менше.
Посібник із стилю JavaScript
- Весь код JavaScript перевіряється за допомогою Prettier і ESLint.