Add clarification on interactive root component remark

[DavidThielen]

Is there an existing issue for this?

• I have searched the existing issues

Describe the bug

In the documentation discussing disabling pre-rendering it says:

Making a root component interactive, such as the App component, isn't supported. Therefore, prerendering can't be disabled directly by the App component.

It then goes on to say:

For apps based on the Blazor Web App project template, a render mode assigned to the entire app is specified where the Routes component is used in the App component (Components/App.razor). The following example sets the app's render mode to Interactive Server with prerendering disabled:

So it says you can't set this in App.razor. Then tells you to turn it off globally, set it to false in App.razor. This needs to say one or the other as both cannot be correct at the same time.

Expected Behavior

It should state that either prerendering can not be set in App.razor and it then shows an example of how to then set it in every top level component.

Or it should state that it can be set in App.razor and then keep the existing example.

Steps To Reproduce

Read the documentation

Exceptions (if any)

No response

.NET Version

8

Anything else?

No response

[javiercn]

@DavidThielen thanks for contacting us.

I think the confusion comes here from the fact that you can't make the App component itself interactive, but for disabling interactivity globally, the way it's done is by setting the value at the callsite of the Routes component inside the App component.

[javiercn]

@guardrex feel free to update the docs if you feel we need to be more explicit here.

[DavidThielen]

@javiercn That makes sense.

@guardrex I think adding javiercn's sentence to the documentation would resolve this issue.

thanks - dave

[guardrex]

It's already resolved, and the update will probably go live by EOD. Thanks for the feedback on that point.