From 0051f94430246bb2d5e7b7869f25535747667b36 Mon Sep 17 00:00:00 2001 From: Jimmy Jia Date: Thu, 7 Jul 2016 13:02:03 -0400 Subject: [PATCH] Remove docs on absolute paths --- docs/guides/RouteConfiguration.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/guides/RouteConfiguration.md b/docs/guides/RouteConfiguration.md index b9b5f3ecfb..340c219f66 100644 --- a/docs/guides/RouteConfiguration.md +++ b/docs/guides/RouteConfiguration.md @@ -106,7 +106,7 @@ URL | Components ### Decoupling the UI from the URL -It would be nice if we could remove the `/inbox` segment from the `/inbox/messages/:id` URL pattern, but still render `Message` nested inside the `App -> Inbox` UI. Absolute `path`s let us do exactly that. +It would be nice if we could remove the `/inbox` segment from the `/inbox/messages/:id` URL pattern, but still render `Message` nested inside the `App -> Inbox` UI. Pathless routes let us do exactly that. ```js render(( @@ -125,7 +125,7 @@ render(( ), document.body) ``` -The ability to use absolute paths in deeply nested routes gives us complete control over what the URL looks like! We don't have to add more segments to the URL just to get nested UI. +The ability to use declare routes without paths gives us complete control over what the URL looks like! We don't have to add more segments to the URL just to get nested UI. We can now render the following URLs: @@ -136,8 +136,6 @@ URL | Components `/inbox` | `App -> Inbox` `/messages/:id` | `App -> Inbox -> Message` -**Note**: Absolute paths may not be used in route config that is [dynamically loaded](/docs/guides/DynamicRouting.md). - ### Preserving URLs Wait a minute ... we just changed a URL! [That's not cool](http://www.w3.org/Provider/Style/URI.html). Now everyone who had a link to `/inbox/messages/5` has a **broken link**. :( @@ -184,7 +182,7 @@ Continuing with our example above, if a user clicked on a link to `/about` from Since [routes](/docs/Glossary.md#route) are usually nested, it's useful to use a concise nested syntax like [JSX](https://facebook.github.io/jsx/) to describe their relationship to one another. However, you may also use an array of plain [route](/docs/Glossary.md#route) objects if you prefer to avoid using JSX. -The `` configuration helper is not available when using plain routes, so you have to set up the redirect using the `onEnter` hook. +The `` configuration helper is not available when using plain routes, so you have to set up the redirect using the `onEnter` hook. The route config we've discussed up to this point could also be specified like this: