Важнейшим и активным репозиториям уделяется больше внимания при рассмотрении, в то время как PR (Pull Request) в небольшие неактивные репозитории могут ожидать некоторое время, прежде чем мы периодически просмотрим и рассмотрим ожидающие PR в пакетном режиме.

Ошибки

Мы используем проблемы GitHub для наших публичных ошибок. Если вы хотите сообщить о проблеме, посмотрите вокруг и узнайте, не открыл ли кто-нибудь уже проблему по этому поводу. Если вы уверены, что это новая незарегистрированная ошибка, вы можете отправить [отчёт об ошибке](#отчёт о новых проблемах).

Если у вас есть вопросы об использовании Svelte, свяжитесь с нами в Discord по адресу svelte.dev/chat, и мы сделаем всё возможное, чтобы ответить на ваши вопросы.

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

Отчёт о новых ошибках

При открытии новой проблемы всегда заполняйте шаблон проблемы. Этот шаг очень важен! Невыполнение этого требования может привести к тому, что ваша проблема не будет решена своевременно. Не принимайте это на свой счёт, если это произойдёт, и не стесняйтесь открыть новую проблему, как только соберёте всю информацию, требуемую шаблоном.

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

Pull requests

ВНИМАНИЕ: Svelte 5, вероятно, сильно изменится в компиляторе. По этой причине, пожалуйста, не открывайте PR, которые имеют большой объём, затрагивают более пары файлов и т. д. Другими словами, исправления ошибок — это нормально, но большие PR функций, скорее всего, не будут объединены.

Предложение изменения

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

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

Небольшие запросы на вытягивание легче просматривать и они с большей вероятностью будут объединены.

Установка

Убедитесь, что у вас установлен pnpm. После клонирования репозитория запустите pnpm install.

Разработка

Чтобы собрать UMD-версию svelte/compiler (это необходимо только для потребителей CommonJS или для использования в браузере), запустите pnpm build внутри packages/svelte. Чтобы перестраивать каждый раз, когда изменяются исходные файлы, запустите pnpm dev.

Создание ветки

Форкните репозиторий и создайте свою ветку из main. Если вы никогда раньше не отправляли запрос на GitHub, вы можете узнать, как это сделать, из этого бесплатного видеокурса.

Тестирование

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

• Если вы изменили API, обновите документацию.

Написание тестов

Все тесты находятся в папке /test.

Образцы тестов хранятся в папке /test/xxx/samples.

Запуск тестов

ПРЕДПОСЫЛКА: Установите chromium через playwright, запустив pnpm playwright install chromium

1. Для запуска теста запустите pnpm test.

2. Чтобы запустить конкретный набор тестов, используйте pnpm test <suite-name>, например:

   pnpm test validator

3. Чтобы отфильтровать тесты внутри набора тестов, используйте pnpm test <suite-name> -- -t <test-name>, например:

   pnpm test validator -- -t a11y-alt-text

   (Вы также можете использовать FILTER=<test-name> pnpm test <suite-name>, который удаляет другие тесты, а не просто пропускает их — это приведёт к более быстрым и компактным результатам тестов, но это не идиоматично. Выберите свой вариант.)