Вклад в VS Code

Добро пожаловать и спасибо за ваш интерес к участию в разработке VS Code!

Существует несколько способов внести свой вклад помимо написания кода. Цель этого документа — дать общее представление о том, как вы можете принять участие.

Задавать вопросы

Есть вопрос? Вместо того чтобы открывать проблему, пожалуйста, задайте его на Stack Overflow, используя тег visual-studio-code.

Активное сообщество будет радо помочь вам. Ваш хорошо сформулированный вопрос послужит ресурсом для других, ищущих помощи.

Предоставлять обратную связь

Ваши комментарии и обратная связь приветствуются, а команда разработчиков доступна через несколько различных каналов.

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

Сообщать о проблемах

Вы обнаружили воспроизводимую проблему в VS Code? У вас есть запрос на функцию? Мы хотим услышать об этом! Вот как можно сообщить о проблеме максимально эффективно.

Определите, куда сообщать

Проект VS Code распределён по нескольким репозиториям. Попробуйте зарегистрировать проблему в правильном репозитории. Проверьте список Связанных проектов, если вы не уверены, какой репозиторий правильный.

Можете ли вы воссоздать проблему даже после отключения всех расширений? Если вы обнаружите, что проблема вызвана установленным вами расширением, пожалуйста, создайте проблему непосредственно в репозитории расширения.

Ищите существующую проблему

Прежде чем создавать новую проблему, выполните поиск в открытых проблемах, чтобы узнать, была ли уже зарегистрирована эта проблема или запрос функции.

Обязательно просмотрите самые популярные запросы функций.

Если вы найдёте свою проблему, добавьте соответствующие комментарии и добавьте свою реакцию. Используйте реакцию вместо комментария «+1»:

• 👍 - проголосовать
• 👎 - проголосовать против

Если вы не можете найти существующую проблему, описывающую вашу ошибку или функцию, создайте новую проблему, следуя приведённым ниже рекомендациям.

Написание хороших отчётов об ошибках и запросов функций

Создайте одну проблему для каждой проблемы и запроса функции. Не перечисляйте несколько ошибок или запросов функций в одной проблеме.

Не добавляйте свою проблему в качестве комментария к существующей проблеме, если только это не идентичный ввод. Многие проблемы выглядят похоже, но имеют разные причины.

Чем больше информации вы предоставите, тем больше вероятность того, что кто-то успешно воспроизведёт проблему и найдёт решение.

Встроенный инструмент для сообщения о проблеме, доступ к которому можно получить с помощью «Сообщить о проблеме» в меню «Справка» VS Code, может помочь упростить этот процесс, автоматически предоставляя версию VS Code, все установленные вами расширения и информацию о вашей системе. Кроме того, инструмент будет искать среди существующих проблем, чтобы увидеть, существует ли аналогичная проблема.

Пожалуйста, включите следующее в каждую проблему:

• Версия VS Code
• Ваша операционная система
• Список установленных расширений
• Воспроизводимые шаги (1... 2... 3...), которые вызывают проблему
• Что вы ожидали увидеть по сравнению с тем, что вы на самом деле увидели
• Изображения, анимации или ссылку на видео, демонстрирующее возникновение проблемы
• Фрагмент кода, который демонстрирует проблему, или ссылку на репозиторий кода, который разработчики могут легко загрузить, чтобы воссоздать проблему локально
  • Примечание: поскольку разработчикам необходимо скопировать и вставить фрагмент кода, включение фрагмента кода в виде медиафайла (например, .gif) недостаточно.
• Ошибки из консоли Dev Tools (открыть из меню: Справка > Переключить инструменты разработчика)

Создание запросов на вытягивание

• Пожалуйста, обратитесь к статье о создании запросов на вытягивание и участии в этом проекте. Пожалуйста, не забудьте сделать следующее:
• поискать в репозитории проблем, чтобы убедиться, что ваш отчёт — это новая проблема;
• воссоздать проблему после отключения всех расширений;
• упростить свой код вокруг проблемы, чтобы лучше изолировать её.

Не расстраивайтесь, если разработчики не смогут сразу воспроизвести проблему. Они просто запросят дополнительную информацию!

Отслеживание вашей проблемы

После отправки ваш отчёт поступит в рабочий процесс отслеживания проблем issue tracking. Убедитесь, что вы понимаете, что произойдёт дальше, чтобы знать, чего ожидать и как продолжать помогать на протяжении всего процесса.

Автоматизированное управление проблемами

Мы используем GitHub Actions, чтобы помочь нам управлять проблемами. Эти действия и их описания можно посмотреть здесь. Вот некоторые примеры того, что делают эти действия:

• автоматически закрывают любую проблему, помеченную как info-needed, если в течение последних 7 дней не было ответа;
• автоматически блокируют проблемы через 45 дней после их закрытия;
• автоматически реализуют конвейер запросов функций VS Code feature request pipeline.

Если вы считаете, что бот что-то сделал неправильно, пожалуйста, откройте новую проблему и сообщите нам об этом.

Внесение исправлений

Если вы заинтересованы в написании кода для исправления проблем, пожалуйста, ознакомьтесь с разделом Как внести свой вклад в вики.

Спасибо вам

Ваш вклад в открытый исходный код, большой или маленький, делает такие замечательные проекты возможными. Спасибо, что нашли время внести свой вклад.