docs: reorder example

netlify.toml

@@ -1,5 +1,6 @@
 [build.environment]
 CHROMEDRIVER_SKIP_DOWNLOAD = "true"
+NODE_VERSION = "18"
 
 [build]
 command = "pnpm run docs:build"

packages/docs/api/interfaces/Router.md

@@ -100,6 +100,8 @@ function that removes the registered hook.
 
 `fn`
 
+a function that removes the registered hook
+
 ▸ (): `void`
 
 Add a navigation hook that is executed after every navigation. Returns a
@@ -109,6 +111,8 @@ function that removes the registered hook.
 
 `void`
 
+a function that removes the registered hook
+
 **`Example`**
 
 ```js
@@ -191,6 +195,8 @@ registered guard.
 
 `fn`
 
+a function that removes the registered guard
+
 ▸ (): `void`
 
 Add a navigation guard that executes before navigation is about to be
@@ -202,6 +208,8 @@ registered guard.
 
 `void`
 
+a function that removes the registered guard
+
 **`Example`**
 
 ```js

packages/router/src/errors.ts

@@ -144,6 +144,9 @@ export function createRouterError<E extends RouterError>(
 /**
  * Check if an object is a {@link NavigationFailure}.
  *
+ * @param error - possible {@link NavigationFailure}
+ * @param type - optional types to check for
+ *
  * @example
  * ```js
  * import { isNavigationFailure, NavigationFailureType } from 'vue-router'
@@ -163,8 +166,6 @@ export function createRouterError<E extends RouterError>(
  *   }
  * })
  * ```
- * @param error - possible {@link NavigationFailure}
- * @param type - optional types to check for
  */
 export function isNavigationFailure(
   error: any,

packages/router/src/router.ts

@@ -287,20 +287,26 @@ export interface Router {
    * navigation guards have been successful. Returns a function that removes the
    * registered guard.
    *
+   * @param guard - navigation guard to add
+   * @returns a function that removes the registered guard
+   *
    * @example
    * ```js
    * router.beforeResolve(to => {
    *   if (to.meta.requiresAuth && !isAuthenticated) return false
    * })
    * ```
    *
-   * @param guard - navigation guard to add
    */
   beforeResolve(guard: NavigationGuardWithThis<undefined>): () => void
+
   /**
    * Add a navigation hook that is executed after every navigation. Returns a
    * function that removes the registered hook.
    *
+   * @param guard - navigation hook to add
+   * @returns a function that removes the registered hook
+   *
    * @example
    * ```js
    * router.afterEach((to, from, failure) => {
@@ -309,8 +315,6 @@ export interface Router {
    *   }
    * })
    * ```
-   *
-   * @param guard - navigation hook to add
    */
   afterEach(guard: NavigationHookAfter): () => void