Standard prerequisite wording when something requires on-demand rendering #12121
sarah11918
started this conversation in
Ideas
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
-
We have several pages, especially 3rd-party guides and recipes, where we list prerequisites. e.g.:
Some of them specifically say "with an adapter installed for on-demand rendering." Some of them more generally say something like "with on demand rendering enabled." Some of them still say that
output: 'server'
is required (which may be required in some cases I guess, but I think it's probably worth checking that you really must or should change the build output, since we typically recommend against that unless you determine it's needed.)I'd love for us to arrive at some standard wording, then update the docs throughout. I'll start the ball rolling:
I think in most cases, suggesting to install an adapter for on-demand rendering is probably the way to go (better than just "enabling" because it doesn't specify how), and we should check to make sure that
output: 'server'
is actually required to switch every page to on-demand rendering when using that third party service.Something like this in most cases, where this is only needed in one file, e.g. on a dynamic route:
And where absolutely confirmed to be the better choice:
Follow up tasks
After deciding on standard wording:
'server'
mode is the recommendationexport const prerender = false
in the case we do NOT suggest server mode where necessary.output: 'server'
is only shown for the cases where we've stated it as a prerequisite.Beta Was this translation helpful? Give feedback.
All reactions