From: Eduardo San Martin Morote <posva13@gmail.com>
Date: Tue, 6 Oct 2020 12:24:55 +0000 (+0200)
Subject: docs(migration): improve catch all change
X-Git-Tag: v4.0.0-rc.1~38
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d5650b6cd5e2be1f442dd87c86c1644e49e620c4;p=thirdparty%2Fvuejs%2Frouter.git

docs(migration): improve catch all change
---

diff --git a/docs/guide/migration/index.md b/docs/guide/migration/index.md
index 3cf58629..51f97825 100644
--- a/docs/guide/migration/index.md
+++ b/docs/guide/migration/index.md
@@ -155,11 +155,13 @@ Catch all routes (`*`, `/*`) must now be defined using a parameter with a custom
 const routes = [
   // pathMatch is the name of the param, e.g., going to /not/found yields
   // { params: { pathMatch: ['not', 'found'] }}
+  // this is thanks to the last *, meaning repeated params and it is necessary if you
+  // plan on directly navigating to the not-found route using its name
   { path: '/:pathMatch(.*)*', name: 'not-found', component: NotFound },
   // if you omit the last `*`, the `/` character in params will be encoded when resolving or pushing
   { path: '/:pathMatch(.*)', name: 'bad-not-found', component: NotFound },
 ]
-// bad example:
+// bad example if using named routes:
 router.resolve({
   name: 'bad-not-found',
   params: { pathMatch: 'not/found' },
@@ -171,7 +173,11 @@ router.resolve({
 }).href // '/not/found'
 ```
 
-**Reason**: Vue Router doesn't use `path-to-regexp` anymore, instead it implements its own parsing system that allows route ranking and enables dynamic routing. Since we usually add one single catch-all route per project, there is no big benefit in supporting a special syntax for `*`.
+:::tip
+You don't need to add the `*` for repeated params if you don't plan to directly push to the not found route using its name. If you call `router.push('/not/found/url')`, it will provide the right `pathMatch` param.
+:::
+
+**Reason**: Vue Router doesn't use `path-to-regexp` anymore, instead it implements its own parsing system that allows route ranking and enables dynamic routing. Since we usually add one single catch-all route per project, there is no big benefit in supporting a special syntax for `*`. The encoding of params is encoding across routes, without exception to make things easier to predict.
 
 ### Replaced `onReady` with `isReady`