Merge pull request #829 from StrahilKazlachev/doc/add-warning/set-root

doc(app-configuration-and-startup): add warning about setRoot
aurelia · Oct 2, 2017 · c64f0e6 · c64f0e6
2 parents d67227e + 9145bcc
commit c64f0e6
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/doc/article/en-US/app-configuration-and-startup.md b/doc/article/en-US/app-configuration-and-startup.md
@@ -143,6 +143,10 @@ The root component is set by calling `aurelia.setRoot()`. If no values are provi
 
 This causes the `my-root${context.language.fileExtension}`/`my-root.html` to be loaded as the root component and injected into the `some-element` HTML element.
 
+> Note: The content of the app host element, the one marked with `aurelia-app` or passed to `Aurelia.prototype.setRoot`, will be replaced when `Aurelia.prototype.setRoot` completes.
+
+> Warning: When using the `<body>` element as the app host, bear in mind that any content added prior to the completion of `Aurelia.prototype.setRoot` will be removed.
+
 ## [Bootstrapping Older Browsers](aurelia-doc://section/3/version/1.0.0)
 
 Aurelia was originally designed for Evergreen Browsers. This includes Chrome, Firefox, IE11 and Safari 8. However, we also support IE9 and above through the use of additional polyfills. To support these earlier browsers, you need the [requestAnimationFrame Polyfill](https://www.npmjs.com/package/raf) and the [MutationObserver polyfill](https://github.com/megawac/MutationObserver.js). Once you have installed these (via `npm install --save-dev raf mutationobserver-shim`), you'll need to adjust your code to load them before Aurelia is initialized.