Вклад в проект

Какой вклад принимается?

Вкратце, мы открыты почти для всех вкладов! Мы любим обратную связь во всех формах: проблемы, комментарии, PR и т. д.!

Внесение больших изменений, новых функций и т.д.

Если вы не уверены, что ваше изменение будет принято (тривиальные исправления ошибок, очистка кода и т. п.), вам следует сначала создать проблему или Sourcegraph RFC (предпочтительно для более крупных изменений), чтобы обсудить ваше изменение с нами. Это позволяет нам всем обсудить дизайн и предлагаемую реализацию вашего изменения, что помогает обеспечить эффективное использование вашего времени и принятие вашего вклада.

Исключение: Если вы вносите функциональность, которая уже существует как платная функция Sourcegraph, мы вряд ли примем её. Предварительно проконсультируйтесь с нами для получения окончательного ответа. (Мы добавим больше деталей о процессе здесь, и они будут похожи на принципы управления GitLab.)

Кодекс поведения

Все взаимодействия с открытым исходным проектом Sourcegraph регулируются Кодексом поведения сообщества Sourcegraph.

Как внести свой вклад

1. Выберите одну из проблем, помеченных как хорошая первая проблема.
2. Клонируйте репозиторий: git clone https://github.com/sourcegraph/sourcegraph.
3. Настройте свою среду разработки, чтобы запустить проект локально.
4. Прежде чем создавать запрос на вытягивание, убедитесь, что рекомендованные проверки проходят локально. Мы активно работаем над тем, чтобы сделать наш CI-конвейер общедоступным для автоматизации этого шага.
5. ВАЖНО: Как только у вас будет готов к рассмотрению запрос на вытягивание, проверка «verification/cla-signed» будет отмечена, и вам будет предложено подписать CLA с помощью ссылки, предоставленной нашим ботом. После подписания добавьте комментарий с пометкой @sourcegraph/contribution-reviewers. После этого ваш запрос на вытягивание будет готов к просмотру.
   • Для членов команды Sourcegraph см. эти примечания о том, как убедиться, что CLA был подписан.
6. Как только вы выбрали проблему, прокомментируйте её, чтобы объявить, что вы будете работать над ней, сделав её видимой для других, что эта проблема решается. Если вы в конечном итоге не создадите запрос на вытягивание для этой проблемы, пожалуйста, удалите свой комментарий.
7. Если у вас есть какие-либо вопросы, пожалуйста, сначала обратитесь к документации. Если вы не найдёте никакой соответствующей информации, упомяните автора проблемы.
8. Автор проблемы постарается предоставить руководство. Sourcegraph всегда работает в асинхронном режиме. Мы постараемся ответить как можно скорее, но, пожалуйста, учитывайте разницу часовых поясов.
9. Присоединяйтесь к пространству сообщества Sourcegraph на Discord, где команда Sourcegraph может вам помочь!

Могу ли я взять эту задачу?

Все открытые проблемы ещё не решены. Если задача вам интересна, берите её и смело делайте. Нет необходимости спрашивать разрешения или становиться в очередь. Даже если кто-то другой может выполнить задачу быстрее, чем вы, не останавливайтесь — ваше решение может быть лучше. В этом прелесть открытого исходного кода!

Соответствующие документы по разработке

Запуск приложений

• Руководство по началу работы
• Раздел Устранение неполадок

Как писать тесты

• Как писать тесты
• Принципы тестирования
• Тестирование веб-кода

Запросы на вытягивание

• [Как Структура:

• Соглашение об именовании ветвей Git: [инициалы разработчика]/[краткое описание функции].

• Примеры на Github: https://github.com/sourcegraph/sourcegraph/pulls?q=is%3Apr+label%3Ateam%2Ffrontend-platform.

• (Для команды Sourcegraph) Как принимать вклад: https://docs-legacy.sourcegraph.com/dev/contributing/accepting_contribution.