docs(router): copyedits #3054
docs(router): copyedits #3054
Conversation
|
This is great. But I need to copy edit a few of the copy edits and this branch isn't in the IdeaBlade repo (ahem!). Therefore, I had to close and move it to a new PR #3060 |
| It renders in the the DOM as a `<router-outlet>` element. | ||
| The router inserts the outlet's view components as sibling elements, | ||
| immediately _after_ the closing `</router-outlet>` tag. | ||
| The `<router-outlet>` element is rendered in the DOM. |
There was a problem hiding this comment.
Needed more thorough rewrite
| @@ -567,24 +570,24 @@ a#default-route | |||
| :marked | |||
| ### The _default_ route to heroes | |||
|
|
|||
| When the application launches, the initial URL in the browser bar is something like: | |||
| When the application launches, an initial URL in the browser bar is something like: | |||
There was a problem hiding this comment.
Disagree: "the" was correct. There can be only one "initial" url
|
|
||
| a#redirect | ||
| :marked | ||
| ### Redirecting routes | ||
|
|
||
| The preferred solution is to add a `redirect` route that translates from the initial relative URL (`''`) | ||
| to the desired default path (`/heroes`). The browser address bar shows `~/heroes` as if you'd navigated there directly. | ||
| The preferred solution is to add a `redirect` route that translates an initial relative URL (`''`) |
There was a problem hiding this comment.
reverting to "the"; see comment above.
| The first step is to **create a separate `app/heroes/` folder** | ||
| and add *Hero Management* feature files there. | ||
| This example has capabilities very similar to the | ||
| [Tour of Heroes tutorial, Part 5](../tutorial/toh-pt5.html), |
There was a problem hiding this comment.
Actually, per issue #3055, we should have been referring to the "Services" episode. Fixing that in my update.
| The new *Crisis Center* begins as a virtual copy of the *Heroes* module. | ||
| Create a new `app/crisis-center` folder, copy the Hero files, | ||
| and change every mention of "hero" to "crisis". | ||
| It's time to add real features to the app's current placeholder crisis center. |
There was a problem hiding this comment.
Agree this passage needed work. I took it a bit further.
| :marked | ||
| While building out the *Crisis Center* feature, you navigated to the | ||
| *Crisis Detail* route using a so-called **absolute path** that begins with a _slash_. | ||
| ### Relative navigation |
There was a problem hiding this comment.
I always add an explicit anchor in case the section title changes; don't want to break external links.
|
Thanks Ward. Sorry, that I forgot to commit to the IdeaBlade repo (I hit the publish button in the GH app out of habit, as I usually do for my Dart work). I'll commit to IB repo once again moving forward. |
* docs(router): chalin copyedits * docs(router): bell copy edits + routing module order & inspect config
Continuation of #3025.
cc @wardbell @kwalrath