From 9810e5b3b838b7b629c2bd9e1b558cedcee8a5f4 Mon Sep 17 00:00:00 2001
From: guardrex <1622880+guardrex@users.noreply.github.com>
Date: Fri, 4 Sep 2020 09:35:35 -0500
Subject: [PATCH 1/5] Enhance Blazor start content

---
 .../fundamentals/additional-scenarios.md      | 68 ++++++++++++++-----
 1 file changed, 50 insertions(+), 18 deletions(-)

diff --git a/aspnetcore/blazor/fundamentals/additional-scenarios.md b/aspnetcore/blazor/fundamentals/additional-scenarios.md
index 9e37e8192304..23589c196d0c 100644
--- a/aspnetcore/blazor/fundamentals/additional-scenarios.md
+++ b/aspnetcore/blazor/fundamentals/additional-scenarios.md
@@ -112,18 +112,52 @@ Blazor Server apps are set up by default to prerender the UI on the server befor
 
 Rendering server components from a static HTML page isn't supported.
 
-## Configure the SignalR client for Blazor Server apps
+## Manual start of the Blazor app
 
 *This section applies to Blazor Server.*
 
-Configure the SignalR client used by Blazor Server apps in the `Pages/_Host.cshtml` file. Place a script that calls `Blazor.start` after the `_framework/blazor.server.js` script and inside the `</body>` tag.
+Configure the manual start of a Blazor Server app in the `Pages/_Host.cshtml` file:
 
-### Logging
+* Add an `autostart="false"` attribute to the `<script>` tag for the `blazor.server.js` script.
+* Place a script that calls `Blazor.start` after the `_framework/blazor.server.js` script and inside the closing `</body>` tag.
 
-To configure SignalR client logging:
+### Initialize Blazor when the document is ready
 
-* Add an `autostart="false"` attribute to the `<script>` tag for the `blazor.server.js` script.
-* Pass in a configuration object (`configureSignalR`) that calls `configureLogging` with the log level on the client builder.
+To initialize the Blazor app when the document is ready:
+
+```cshtml
+    ...
+
+    <script autostart="false" src="_framework/blazor.server.js"></script>
+    <script>
+      document.addEventListener("DOMContentLoaded", function() {
+        Blazor.start();
+      });
+    </script>
+</body>
+```
+
+### Chain to the `Promise` that results from a manual start
+
+To perform additional tasks, such as JS interop initialization, use `then` to chain to the `Promise` that results from a manual Blazor app start:
+
+```cshtml
+    ...
+
+    <script autostart="false" src="_framework/blazor.server.js"></script>
+    <script>
+      Blazor.start().then(function () {
+        ...
+      });
+    </script>
+</body>
+```
+
+### Configure the SignalR client
+
+#### Logging
+
+To configure SignalR client logging, pass in a configuration object (`configureSignalR`) that calls `configureLogging` with the log level on the client builder:
 
 ```cshtml
     ...
@@ -148,10 +182,12 @@ The reconnection handler's circuit connection events can be modified for custom
 * To notify the user if the connection is dropped.
 * To perform logging (from the client) when a circuit is connected.
 
-To modify the connection events:
+To modify the connection events, register callbacks for the following connection changes:
 
-* Add an `autostart="false"` attribute to the `<script>` tag for the `blazor.server.js` script.
-* Register callbacks for connection changes for dropped connections (`onConnectionDown`) and established/re-established connections (`onConnectionUp`). **Both** `onConnectionDown` and `onConnectionUp` must be specified.
+* Dropped connections use `onConnectionDown`.
+* Established/re-established connections use `onConnectionUp`.
+
+**Both** `onConnectionDown` and `onConnectionUp` must be specified:
 
 ```cshtml
     ...
@@ -170,10 +206,7 @@ To modify the connection events:
 
 ### Adjust the reconnection retry count and interval
 
-To adjust the reconnection retry count and interval:
-
-* Add an `autostart="false"` attribute to the `<script>` tag for the `blazor.server.js` script.
-* Set the number of retries (`maxRetries`) and period in milliseconds permitted for each retry attempt (`retryIntervalMilliseconds`).
+To adjust the reconnection retry count and interval, set the number of retries (`maxRetries`) and period in milliseconds permitted for each retry attempt (`retryIntervalMilliseconds`):
 
 ```cshtml
     ...
@@ -190,12 +223,9 @@ To adjust the reconnection retry count and interval:
 </body>
 ```
 
-### Hide or replace the reconnection display
-
-To hide the reconnection display:
+## Hide or replace the reconnection display
 
-* Add an `autostart="false"` attribute to the `<script>` tag for the `blazor.server.js` script.
-* Set the reconnection handler's `_reconnectionDisplay` to an empty object (`{}` or `new Object()`).
+To hide the reconnection display, set the reconnection handler's `_reconnectionDisplay` to an empty object (`{}` or `new Object()`):
 
 ```cshtml
     ...
@@ -205,6 +235,8 @@ To hide the reconnection display:
       window.addEventListener('beforeunload', function () {
         Blazor.defaultReconnectionHandler._reconnectionDisplay = {};
       });
+
+      Blazor.start();
     </script>
 </body>
 ```

From bed6de6b90c490bb744712c8291d6a9ebe04b42f Mon Sep 17 00:00:00 2001
From: guardrex <1622880+guardrex@users.noreply.github.com>
Date: Tue, 8 Sep 2020 06:44:04 -0500
Subject: [PATCH 2/5] Updates

---
 .../fundamentals/additional-scenarios.md       | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/aspnetcore/blazor/fundamentals/additional-scenarios.md b/aspnetcore/blazor/fundamentals/additional-scenarios.md
index 23589c196d0c..b5abc3dd9f31 100644
--- a/aspnetcore/blazor/fundamentals/additional-scenarios.md
+++ b/aspnetcore/blazor/fundamentals/additional-scenarios.md
@@ -116,16 +116,20 @@ Rendering server components from a static HTML page isn't supported.
 
 *This section applies to Blazor Server.*
 
-Configure the manual start of a Blazor Server app in the `Pages/_Host.cshtml` file:
+Configure the manual start of a Blazor Server app's [SignalR circuit](xref:blazor/hosting-models#circuits) in the `Pages/_Host.cshtml` file:
 
 * Add an `autostart="false"` attribute to the `<script>` tag for the `blazor.server.js` script.
-* Place a script that calls `Blazor.start` after the `_framework/blazor.server.js` script and inside the closing `</body>` tag.
+* Place a script that calls `Blazor.start` after the `blazor.server.js` script's tag and inside the closing `</body>` tag.
+
+When `autostart` is disabled, any aspect of the app that doesn't depend on the circuit works normally. For example, client-side routing is operational. However, any aspect that depends on the circuit isn't operational until `Blazor.start` is called. For example, component methods fail to execute when called while the circuit is disconnected.
 
 ### Initialize Blazor when the document is ready
 
 To initialize the Blazor app when the document is ready:
 
 ```cshtml
+<body>
+
     ...
 
     <script autostart="false" src="_framework/blazor.server.js"></script>
@@ -142,6 +146,8 @@ To initialize the Blazor app when the document is ready:
 To perform additional tasks, such as JS interop initialization, use `then` to chain to the `Promise` that results from a manual Blazor app start:
 
 ```cshtml
+<body>
+
     ...
 
     <script autostart="false" src="_framework/blazor.server.js"></script>
@@ -160,6 +166,8 @@ To perform additional tasks, such as JS interop initialization, use `then` to ch
 To configure SignalR client logging, pass in a configuration object (`configureSignalR`) that calls `configureLogging` with the log level on the client builder:
 
 ```cshtml
+<body>
+
     ...
 
     <script autostart="false" src="_framework/blazor.server.js"></script>
@@ -190,6 +198,8 @@ To modify the connection events, register callbacks for the following connection
 **Both** `onConnectionDown` and `onConnectionUp` must be specified:
 
 ```cshtml
+<body>
+
     ...
 
     <script autostart="false" src="_framework/blazor.server.js"></script>
@@ -209,6 +219,8 @@ To modify the connection events, register callbacks for the following connection
 To adjust the reconnection retry count and interval, set the number of retries (`maxRetries`) and period in milliseconds permitted for each retry attempt (`retryIntervalMilliseconds`):
 
 ```cshtml
+<body>
+
     ...
 
     <script autostart="false" src="_framework/blazor.server.js"></script>
@@ -228,6 +240,8 @@ To adjust the reconnection retry count and interval, set the number of retries (
 To hide the reconnection display, set the reconnection handler's `_reconnectionDisplay` to an empty object (`{}` or `new Object()`):
 
 ```cshtml
+<body>
+
     ...
 
     <script autostart="false" src="_framework/blazor.server.js"></script>

From 7b3e5aaba591123d5f7c03ab11edaabf5424267f Mon Sep 17 00:00:00 2001
From: guardrex <1622880+guardrex@users.noreply.github.com>
Date: Wed, 9 Sep 2020 08:28:35 -0500
Subject: [PATCH 3/5] Update

---
 aspnetcore/blazor/fundamentals/additional-scenarios.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/aspnetcore/blazor/fundamentals/additional-scenarios.md b/aspnetcore/blazor/fundamentals/additional-scenarios.md
index b5abc3dd9f31..e0dbde41759a 100644
--- a/aspnetcore/blazor/fundamentals/additional-scenarios.md
+++ b/aspnetcore/blazor/fundamentals/additional-scenarios.md
@@ -121,7 +121,7 @@ Configure the manual start of a Blazor Server app's [SignalR circuit](xref:blazo
 * Add an `autostart="false"` attribute to the `<script>` tag for the `blazor.server.js` script.
 * Place a script that calls `Blazor.start` after the `blazor.server.js` script's tag and inside the closing `</body>` tag.
 
-When `autostart` is disabled, any aspect of the app that doesn't depend on the circuit works normally. For example, client-side routing is operational. However, any aspect that depends on the circuit isn't operational until `Blazor.start` is called. For example, component methods fail to execute when called while the circuit is disconnected.
+When `autostart` is disabled, any aspect of the app that doesn't depend on the circuit works normally. For example, client-side routing is operational. However, any aspect that depends on the circuit isn't operational until `Blazor.start` is called. For example, component methods fail to execute while the circuit is disconnected.
 
 ### Initialize Blazor when the document is ready
 

From bc0b4cc9a6ccaf95236ebf08e040b078eca440dd Mon Sep 17 00:00:00 2001
From: guardrex <1622880+guardrex@users.noreply.github.com>
Date: Wed, 9 Sep 2020 10:34:17 -0500
Subject: [PATCH 4/5] Updates

---
 .../blazor/fundamentals/additional-scenarios.md  | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/aspnetcore/blazor/fundamentals/additional-scenarios.md b/aspnetcore/blazor/fundamentals/additional-scenarios.md
index e0dbde41759a..bb67bd80811b 100644
--- a/aspnetcore/blazor/fundamentals/additional-scenarios.md
+++ b/aspnetcore/blazor/fundamentals/additional-scenarios.md
@@ -112,7 +112,7 @@ Blazor Server apps are set up by default to prerender the UI on the server befor
 
 Rendering server components from a static HTML page isn't supported.
 
-## Manual start of the Blazor app
+## Initialize the Blazor circuit
 
 *This section applies to Blazor Server.*
 
@@ -121,7 +121,7 @@ Configure the manual start of a Blazor Server app's [SignalR circuit](xref:blazo
 * Add an `autostart="false"` attribute to the `<script>` tag for the `blazor.server.js` script.
 * Place a script that calls `Blazor.start` after the `blazor.server.js` script's tag and inside the closing `</body>` tag.
 
-When `autostart` is disabled, any aspect of the app that doesn't depend on the circuit works normally. For example, client-side routing is operational. However, any aspect that depends on the circuit isn't operational until `Blazor.start` is called. For example, component methods fail to execute while the circuit is disconnected.
+When `autostart` is disabled, any aspect of the app that doesn't depend on the circuit works normally. For example, client-side routing is operational. However, any aspect that depends on the circuit isn't operational until `Blazor.start` is called. App behavior is unpredictable without an established circuit. For example, component methods fail to execute while the circuit is disconnected.
 
 ### Initialize Blazor when the document is ready
 
@@ -264,6 +264,18 @@ Blazor.defaultReconnectionHandler._reconnectionDisplay =
 
 The placeholder `{ELEMENT ID}` is the ID of the HTML element to display.
 
+::: moniker range=">= aspnetcore-5.0"
+
+Customize the delay before the reconnection display appears by setting the `transition-delay` property in the app's CSS (`wwwroot/css/site.css`) for the modal element. The following example sets the transition delay from 500 ms (default) to 1,000 ms (1 second):
+
+```css
+#transition-delay {
+    transition: visibility 0s linear 1000ms;
+}
+```
+
+::: moniker-end
+
 ## Influence HTML `<head>` tag elements
 
 *This section applies to the upcoming ASP.NET Core 5.0 release of Blazor WebAssembly and Blazor Server.*

From 9d7df62ff299398e7c1b42f40907576ecd95750e Mon Sep 17 00:00:00 2001
From: guardrex <1622880+guardrex@users.noreply.github.com>
Date: Wed, 9 Sep 2020 10:37:13 -0500
Subject: [PATCH 5/5] Update

---
 aspnetcore/blazor/fundamentals/additional-scenarios.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/aspnetcore/blazor/fundamentals/additional-scenarios.md b/aspnetcore/blazor/fundamentals/additional-scenarios.md
index bb67bd80811b..8d896656b814 100644
--- a/aspnetcore/blazor/fundamentals/additional-scenarios.md
+++ b/aspnetcore/blazor/fundamentals/additional-scenarios.md
@@ -269,7 +269,7 @@ The placeholder `{ELEMENT ID}` is the ID of the HTML element to display.
 Customize the delay before the reconnection display appears by setting the `transition-delay` property in the app's CSS (`wwwroot/css/site.css`) for the modal element. The following example sets the transition delay from 500 ms (default) to 1,000 ms (1 second):
 
 ```css
-#transition-delay {
+#components-reconnect-modal {
     transition: visibility 0s linear 1000ms;
 }
 ```