next-runtime icon indicating copy to clipboard operation
next-runtime copied to clipboard

Clarify using `netlify dev` when importing `@netlify/next` in docs

Open sarahetter opened this issue 2 years ago • 4 comments

Related: https://github.com/netlify/next-runtime/issues/2003

User is getting an error if they run next dev when using our advanced middleware - we should make it clear in the documentation for @netlify/next that you must run netlify dev and not next dev because of the edge function.

sarahetter avatar May 02 '23 16:05 sarahetter

Should we move this to https://github.com/netlify/docs now @sarahetter? We moved to the docs site as being the source of truth for the Next runtime. Or should this be in the README?

MarcL avatar May 02 '23 17:05 MarcL

I think the general advice should be always run netlify dev. Usually people run next dev to compare regular Next development mode and Netlify development mode if they run into issues.

nickytonline avatar May 02 '23 18:05 nickytonline

Should we move this to https://github.com/netlify/docs now @sarahetter? We moved to the docs site as being the source of truth for the Next runtime. Or should this be in the README?

This isn't for the runtime, it's for the next package - our advanced middleware

sarahetter avatar May 03 '23 14:05 sarahetter

Ok - The docs for the next package also point to the docs site from the README. It feels like that should still be the source of truth.

MarcL avatar May 05 '23 13:05 MarcL

Superseded by v5. Please feel free to reopen if this is still valid.

serhalp avatar Jun 04 '24 15:06 serhalp