Сообщение об ошибках

Одна из самых ценных ролей в open source — уделить время тому, чтобы полезно сообщить об ошибке.

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

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

Вот несколько ключевых шагов.

Это точно баг?

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

Поиск по существующим задачам

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

Воспроизведите минимальный пример

Важно надёжно воспроизводить ошибку минимальным набором кода и отдельно от остального проекта. Так проще найти причину и проверить возможное исправление.

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

Если проблема связана с Vue или Vite, сначала попробуйте воспроизвести её на стартовом шаблоне Vue SSR.

Nuxt:

Nuxt на StackBlitz

Nuxt на CodeSandbox

Vue:

Vue SSR на StackBlitz

Vue SSR на CodeSandbox

Шаблон Vue SSR на GitHub

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

Где искать причину

В проекте Nuxt много «переменных»: от модулей Nuxt до других пакетов JavaScript. Сообщайте об ошибке в наиболее подходящий репозиторий. Чаще всего это модуль Nuxt или зависимость, от которой зависит Nuxt.