Сообщение о багах

Один из самых ценных вкладов в open source — понятно и полезно описать баг.

Как бы мы ни старались, баги полностью не исчезнут.

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

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

Точно ли это баг?

Подумайте: вам нужна помощь с задачей или вы считаете, что баг в самом Nuxt? В первом случае лучше обратиться за помощью, а не создавать отчёт о баге.

Поиск по issues

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

Минимальное воспроизведение

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

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

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

Nuxt:

Nuxt на StackBlitz

Nuxt на CodeSandbox

Vue:

Vue SSR на StackBlitz

Vue SSR на CodeSandbox

Vue SSR шаблон на GitHub

После воспроизведения уберите из примера всё лишнее (но так, чтобы баг оставался). Время, потраченное на минимизацию, сильно облегчит жизнь тому, кто будет чинить.

Определение возможной причины

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