From 4168157214ea361ad1cd19c43c22973271345b96 Mon Sep 17 00:00:00 2001
From: toto6038 <50100922+toto6038@users.noreply.github.com>
Date: Tue, 9 Jan 2024 09:39:05 +0000
Subject: [PATCH] docs: suggest using `<NuxtPage>` rather than `<RouterView>`
 (#25106)

---
 docs/3.api/1.components/2.nuxt-page.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/3.api/1.components/2.nuxt-page.md b/docs/3.api/1.components/2.nuxt-page.md
index 493c5efb1e..09fe79d3de 100644
--- a/docs/3.api/1.components/2.nuxt-page.md
+++ b/docs/3.api/1.components/2.nuxt-page.md
@@ -15,6 +15,10 @@ links:
 It accepts same `name` and `route` props.
 ::
 
+::callout{color="amber" icon="i-ph-warning-duotone"}
+`<NuxtPage>` should be used instead of `<RouterView>` as the former takes additional care on internal states. Otherwise, `useRoute()` may return incorrect paths.
+::
+
 ## Props
 
 - `name`: tells `RouterView` to render the component with the corresponding name in the matched route record's components option.