Вклад в VS Code

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

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

Задание вопросов

Есть вопрос? Вместо открытия проблемы обратитесь на Stack Overflow с помощью тега visual-studio-code.

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

Предоставление отзывов

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

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

Отчет о проблемах

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

Определение места для отчета

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

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

Поиск существующей проблемы

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

Убедитесь, что просмотрели [самые популярные](https://github.com/microsoft/vscode/issues?q=is%3Aopen+is%3Aissue+label%3A%D0%B4%D0%BE%D0%BC%D0%B5%D0%BD+%D0%BD%D0%BE%D0%B2%D0%BE%D0%B9+%D1%84%D1%83%D0%BD%D0% bonus) запросов на новые функции.

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

Написание хороших отчетов о багах и новых функциях

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

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

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

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

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

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

Создание запросов на слияние

• Пожалуйста, обратитесь к статье о создании запросов на слияние и вкладе в этот проект.

Конечный чеклист

Пожалуйста, запомните следующее:

• Поиск репозитория проблем, чтобы убедиться, что ваш отчет представляет собой новую проблему
• Воспроизведение проблемы после отключения всех расширений
• Упрощение вашего кода вокруг проблемы, чтобы лучше изолировать проблему

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

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

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

Автоматическое управление проблемами

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

• Автоматически закрывать любую проблему, помеченную info-needed, если нет ответа в течение последних семи дней.
• Автоматически блокировать проблемы 45 дней после их закрытия.
• Автоматически реализовывать [канал управления запросами на новые функции VS Code](https://github.com/microsoft/vscode/wiki/%D0%9F%D1%80%D0%BE%D1%86%D0%B5%D1%81%D1%81-%D0%BE%D1%82%D1%81%D0%BB%D0%B5%D0%B6%D0%B8%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-%D0%BF%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC#%D0%BC%D0%B0%D0%BD%D0%B0%D0%B3%D0%B5%D0%BD%D0%B5%D1%80%D1%81%D1%82%D0%B2%D0%B0-%D0%BD%D0%BE%D0%B2%D1%8b%D1%85-%D1%84%D1%83%D0%BD%D0% bonus).Если вы считаете, что бот сделал что-то неверное, пожалуйста, откройте новую проблему и сообщите нам.

Вклад в исправления

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

Благодарность

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