docs: fix outdated references, broken links and typos

Author: benjamincanac

docs/content/2.setup.md

@@ -1,18 +1,18 @@
 ---
 title: Setup
-description: Learn how to setup strapi module in your Nuxt 3 application.
+description: Learn how to setup the Strapi module in your Nuxt application.
 navigation.icon: i-lucide-play
 ---
 
 ## Installation
 
-1. Add `@nuxtjs/strapi` module to your project:
+Add `@nuxtjs/strapi` module to your project:
 
 ```bash
 npx nuxi@latest module add strapi
 ```
 
-2. Add it to the `modules` section in your `nuxt.config.ts`:
+This will add the module to the `modules` section of your `nuxt.config.ts`. You can then configure it:
 
 ```ts [nuxt.config.ts]
 export default defineNuxtConfig({
@@ -39,7 +39,7 @@ Defaults:
 }
 ```
 
-If you want to override any options on runtime, you may use [Nuxt 3 runtime-config](https://nuxt.com/docs/getting-started/configuration#environment-variables-and-private-tokens):
+If you want to override any options on runtime, you may use [Nuxt runtime-config](https://nuxt.com/docs/getting-started/configuration#environment-variables-and-private-tokens):
 
 ```ts [nuxt.config.ts]
 export default defineNuxtConfig({

docs/content/3.usage.md

@@ -10,20 +10,18 @@ navigation.icon: i-lucide-code
 
 Depending on which version you have in your [options](/setup#options), you will be using either the v5 (default), v4 or v3 client.
 
-::prose-tip
+::tip
 All examples below are demonstrated with the default v5 `useStrapi()`. :br
 :br
-Note that v3/v4 expose similar methods with different options. Check out specific types for [v5](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/v5.ts), [v4](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/v4.ts) or [v3](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/v3.ts).
+Note that v3/v4 expose similar methods with different options. Check out specific types for [v5](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/v5.ts), [v4](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/v4.ts) or [v3](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/v3.ts).
 ::
 
 > Learn how to handle Strapi errors globally by using [nuxt hooks](/advanced#errors-handling).
 
-::prose-warning
+::warning
 All examples below are demonstrated with http calls in script setup. However, to handle SSR properly you may want to use [useAsyncData](/advanced#async-data).
 ::
 
-### Types
-
 When using the composable, you can pass in a default data model for all methods.
 
 ```ts
@@ -48,7 +46,7 @@ Get a list of documents. Returns entries matching the query filters (see [parame
 
 - **Arguments:**
   - contentType: `string`
-  - params?: [`Strapi5RequestParams`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/v5.ts)
+  - params?: [`Strapi5RequestParams`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/v5.ts)
   - fetchOptions?: [`FetchOptions`](https://github.com/unjs/ofetch/blob/main/src/types.ts#L34)
 - **Returns:** `Promise<Strapi5ResponseMany<T>>`
 
@@ -71,7 +69,7 @@ Returns a document by `documentId`.
 - **Arguments:**
   - contentType: `string`
   - documentId: `string`
-  - params?: [`Strapi5RequestParams`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/v5.ts) (without `filters`)
+  - params?: [`Strapi5RequestParams`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/v5.ts) (without `filters`)
   - fetchOptions?: [`FetchOptions`](https://github.com/unjs/ofetch/blob/main/src/types.ts#L34)
 - **Returns:** `Promise<Strapi5ResponseSingle<T>>`
 
@@ -95,7 +93,7 @@ Creates a document and returns its value.
 - **Arguments:**
   - contentType: `string`
   - data: `Partial<T>`
-  - params?: [`Strapi5RequestParams`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/v5.ts) (without `filters`)
+  - params?: [`Strapi5RequestParams`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/v5.ts) (without `filters`)
 - **Returns:** `Promise<Strapi5ResponseSingle<T>>`
 
 ```vue
@@ -120,7 +118,7 @@ Partially updates a document by `documentId` and returns its value. Fields that
   - contentType: `string`
   - documentId: `string`
   - data?: `Partial<T>`
-  - params?: [`Strapi5RequestParams`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/v5.ts) (without `filters`)
+  - params?: [`Strapi5RequestParams`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/v5.ts) (without `filters`)
 - **Returns:** `Promise<Strapi5ResponseSingle<T>>`
 
 ```vue
@@ -159,7 +157,7 @@ const onSubmit = async () => {
 </script>
 ```
 
-::prose-tip
+::tip
 Pass `locale` to delete a specific locale version: `_delete('restaurants', id, { locale: 'fr' })`
 ::
 
@@ -169,13 +167,13 @@ Pass `locale` to delete a specific locale version: `_delete('restaurants', id, {
 
 Returns the count of entries matching the query filters. You can read more about parameters [here](https://docs-v3.strapi.io/developer-docs/latest/developer-resources/content-api/content-api.html#api-parameters).
 
-::prose-warning
+::warning
 Available only for `v3` as Strapi v4 can do the same thing with the [Pagination queries](https://docs.strapi.io/developer-docs/latest/developer-resources/database-apis-reference/rest-api.html#pagination) of the `find` method.
 ::
 
 - **Arguments:**
   - contentType: `string`
-  - params?: [`Strapi3RequestParams`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/v3.d.ts#L9)
+  - params?: [`Strapi3RequestParams`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/v3.ts#L9)
 - **Returns:** `Promise<number>`
 
 ```vue
@@ -194,7 +192,7 @@ This composable is an alias of `useStrapiClient` that sets the `url` to `/graphq
 
 - **Arguments:**
   - query: `string|DocumentNode`
-  - variables (optional): [`StrapiGraphqlVariables`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L570)
+  - variables (optional): [`StrapiGraphqlVariables`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L570)
 - **Returns:** `Promise<T>`
 
 ```vue
@@ -205,13 +203,9 @@ const graphql = useStrapiGraphQL()
 // Option 1: use inline query
 const restaurant = await graphql(`
   query {
-    restaurant(id: ${route.params.id}) {
-      data {
-        id
-        attributes {
-          name
-        }
-      }
+    restaurant(documentId: "${route.params.id}") {
+      documentId
+      name
     }
   }
 `)
@@ -223,12 +217,12 @@ const restaurant = await graphql(query, { id: route.params.id })
 
 ## `useStrapiClient`
 
-This composable is a wrapper around [Nuxt 3 `$fetch` helper](https://nuxt.com/docs/api/utils/dollarfetch) that uses [`ofetch`](https://github.com/unjs/ofetch) under the hood. You can use this method to reach custom strapi endpoints not available in the `useStrapi` composable.
+This composable is a wrapper around [Nuxt `$fetch` helper](https://nuxt.com/docs/api/utils/dollarfetch) that uses [`ofetch`](https://github.com/unjs/ofetch) under the hood. You can use this method to reach custom strapi endpoints not available in the `useStrapi` composable.
 
 - **Arguments:**
   - url: `string`
   - fetchOptions?: [`FetchOptions`](https://github.com/unjs/ofetch/blob/main/src/types.ts#L34)
-- **Returns:** `Promise<number>`
+- **Returns:** `Promise<T>`
 
 ```vue
 <script setup lang="ts">

docs/content/4.auth.md

@@ -1,16 +1,16 @@
 ---
 title: Authentication
-description: Learn how to authenticate users with the strapi module in your Nuxt 3 application.
+description: Learn how to authenticate users with the Strapi module in your Nuxt application.
 navigation.icon: i-lucide-lock
 ---
 
-> This module exposes composables that are [auto-imported](https://nuxt.com/docs/guide/directory-structure/composables) by Nuxt 3.
+> This module exposes composables that are [auto-imported](https://nuxt.com/docs/guide/directory-structure/composables) by Nuxt.
 
 ## Configuration
 
 When using `@nuxtjs/strapi` for authentication, the user jwt token will be stored in a cookie (`strapi_jwt` by default). By using the default cookie configuration, the expiration will be set to `Session`, which means the cookie will disappear when the browser is closed, and users will have to log in everytime.
 
-If you want your cookie to stay longer, we recommand to use the configuration below (expiration is set to 14 days, feel free to change it):
+If you want your cookie to stay longer, we recommend using the configuration below (expiration is set to 14 days, feel free to change it):
 
 ```ts [nuxt.config.ts]
 export default defineNuxtConfig({
@@ -47,7 +47,7 @@ const token = useStrapiToken()
 
 This composable exposes all the methods available in the Strapi [Users & Permissions plugin](https://docs.strapi.io/developer-docs/latest/plugins/users-permissions.html).
 
-::prose-tip
+::tip
 On `login`, `register`, `resetPassword` and `authenticateProvider` methods, the user is populated through the [`fetchUser`](/auth#fetchuser) method.
 ::
 
@@ -56,8 +56,8 @@ On `login`, `register`, `resetPassword` and `authenticateProvider` methods, the
 Submit the user's identifier and password credentials for authentication. Sets [`user`](/auth#usestrapiuser) and [`token`](/auth#usestrapitoken).
 
 - **Arguments:**
-  - data: [`StrapiAuthenticationData`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L538)
-- **Returns:** [`Promise<StrapiAuthenticationResponse>`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L533)
+  - data: [`StrapiAuthenticationData`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L538)
+- **Returns:** [`Promise<StrapiAuthenticationResponse>`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L533)
 
 ```vue [pages/login.vue]
 <script setup lang="ts">
@@ -100,8 +100,8 @@ Creates a new user in the database with a default role as `Authenticated`.
 Custom user fields, if added to the content type, e.g. `phoneNumber`, can be added to the payload as well.
 
 - **Arguments:**
-  - data: [`StrapiRegistrationData`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L543)
-- **Returns:** [`Promise<StrapiAuthenticationResponse>`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L533)
+  - data: [`StrapiRegistrationData`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L543)
+- **Returns:** [`Promise<StrapiAuthenticationResponse>`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L533)
 
 ```vue [pages/register.vue]
 <script setup lang="ts">
@@ -125,7 +125,7 @@ const onSubmit = async () => {
 This action sends an email to a user with the link to your own reset password page. The link will be enriched with the url param code that is needed for the [`resetPassword`](/auth#resetpassword).
 
 - **Arguments:**
-  - data: [`StrapiForgotPasswordData`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L550)
+  - data: [`StrapiForgotPasswordData`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L550)
 - **Returns:** `Promise<void>`
 
 ```vue [pages/forgot.vue]
@@ -150,8 +150,8 @@ const onSubmit = async () => {
 This action will update the user password. Sets [`user`](/auth#usestrapiuser) and [`token`](/auth#usestrapitoken).
 
 - **Arguments:**
-  - data: [`StrapiResetPasswordData`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L554)
-- **Returns:** [`Promise<StrapiAuthenticationResponse>`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L533)
+  - data: [`StrapiResetPasswordData`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L554)
+- **Returns:** [`Promise<StrapiAuthenticationResponse>`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L533)
 
 ```vue [pages/reset.vue]
 <script setup lang="ts">
@@ -175,7 +175,7 @@ const onSubmit = async () => {
 You can also update an authenticated user password through the `/change-password` API endpoint:
 
 - **Arguments:**
-  - data: [`StrapiChangePasswordData`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L560)
+  - data: [`StrapiChangePasswordData`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L560)
 - **Returns:** `Promise<void>`
 
 ```vue
@@ -199,7 +199,7 @@ const onSubmit = async () => {
 This action will re-send the confirmation sent after [`registration`](/auth#register).
 
 - **Arguments:**
-  - data: [`StrapiEmailConfirmationData`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L566)
+  - data: [`StrapiEmailConfirmationData`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L566)
 - **Returns:** `Promise<void>`
 
 ```vue
@@ -223,7 +223,7 @@ const onSubmit = async () => {
 Return the correct URL to authenticate with provider.
 
 - **Arguments:**
-  - provider: [`StrapiAuthProvider`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L505)
+  - provider: [`StrapiAuthProvider`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L505)
 - **Returns:** `string`
 
 ```vue [pages/login.vue]
@@ -241,9 +241,9 @@ const onClick = () => {
 Authenticate user with external provider. Sets [`user`](/auth#usestrapiuser) and [`token`](/auth#usestrapitoken).
 
 - **Arguments:**
-  - provider: [`StrapiAuthProvider`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L505)
+  - provider: [`StrapiAuthProvider`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L505)
   - access_token: `string`
-- **Returns:** [`Promise<StrapiAuthenticationResponse>`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/index.d.ts#L533)
+- **Returns:** [`Promise<StrapiAuthenticationResponse>`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/index.ts#L533)
 
 ```vue [pages/auth/[provider]/callback.vue]
 <script setup lang="ts">
@@ -258,7 +258,7 @@ await authenticateProvider('github', route.query.access_token)
 
 Fetch `me` user from `/users/me` route if a [`token`](/auth#usestrapitoken) exists in the cookies then sets [`user`](/auth#usestrapiuser).
 
-::prose-tip
+::tip
 This method is called on the server-side only and the data are hydrated client-side so the HTTP call happens only once. This method is called by default on init through a [Nuxt plugin](https://nuxt.com/docs/guide/directory-structure/plugins), so you don't have to.
 ::
 

docs/content/5.advanced.md

@@ -80,16 +80,16 @@ Here are examples for both `v5`/`v4` and `v3` as the signature between both vers
 ### `v5`/`v4`
 
 ```ts [plugins/strapi.client.ts]
-import type { Strapi4Error, Strapi5Error } from '@nuxtjs/strapi'
+import type { Strapi5Error } from '@nuxtjs/strapi'
 
 export default defineNuxtPlugin((nuxt) => {
-  nuxt.hook('strapi:error' as any, (e: Strapi4Error) => {
+  nuxt.hook('strapi:error' as any, (e: Strapi5Error) => {
     nuxt.$toast.error({ title: e.error.name, description: e.error.message })
   })
 })
 ```
 
-> Check out the [Strapi5Error](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/v5.ts#L3) or [Strapi4Error](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/v4.ts#L3) type.
+> Check out the [Strapi5Error](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/v5.ts#L3) or [Strapi4Error](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/v4.ts#L3) type.
 
 ### `v3`
 
@@ -112,11 +112,11 @@ export default defineNuxtPlugin((nuxt) => {
 })
 ```
 
-> Check out the [Strapi3Error](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/types/v3.d.ts#L3) type.
+> Check out the [Strapi3Error](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/types/v3.ts#L3) type.
 
 ## Override Strapi `/users/me` route
 
-::prose-tip
+::tip
 Since [v1.5.0](https://github.com/nuxt-modules/strapi/releases/tag/v1.5.0) and Strapi [v4.2.2](https://github.com/strapi/strapi/releases/tag/v4.2.2), you can use the [`auth.populate`](/setup#authpopulate) option to populate data from `/users/me` route.
 ::
 
@@ -138,7 +138,7 @@ module.exports = {
 }
 ```
 
-> Note that in Strapi v4 v5, you must enable the `restaurants.find` permission in your admin for the Authenticated role to have the data populated.
+> Note that in Strapi v4/v5, you must enable the `restaurants.find` permission in your admin for the Authenticated role to have the data populated.
 
 ### `v3`
 
@@ -180,7 +180,7 @@ async function onSubmit () {
 </script>
 ```
 
-> Note that you have to use the `client` because `create` and `update` methods sends the [body inside `data`](https://github.com/nuxt-modules/strapi/blob/dev/src/runtime/composables/useStrapi4.ts#L64).
+> Note that you have to use the `client` because `create` and `update` methods sends the [body inside `data`](https://github.com/nuxt-modules/strapi/blob/main/src/runtime/composables/useStrapi4.ts#L64).
 
 ## Use Imported GraphQL
 

docs/content/6.devtools.md

@@ -43,16 +43,14 @@ Restart your Strapi server and it should be ready to be embedded in the devtools
 
 Open your `nuxt.config.ts` and set the `devtools` option to `true`:
 
-::code-group
 ```ts [nuxt.config.ts]
 export default defineNuxtConfig({
   strapi: {
     devtools: true
   }
 })
 ```
-::
 
-::prose-tip{icon="i-lucide-sparkles"}
+::tip
 You should now see your Strapi Admin right into your Nuxt project by opening the devtools :sparkles:
 ::

docs/content/index.md

@@ -48,7 +48,7 @@ Shipped with many features.
   icon: i-simple-icons-nuxtdotjs
   ---
   #title{unwrap="p"}
-  Nuxt 3 Ready
+  Nuxt Ready
   #description{unwrap="p"}
   Leverage our auto-imported [composables](/usage) and our [devtools](/devtools) integration.
   :::
@@ -58,7 +58,7 @@ Shipped with many features.
   icon: i-simple-icons-strapi
   ---
   #title{unwrap="p"}
-  Strapi v4/v3/v5
+  Strapi v5/v4/v3
   #description{unwrap="p"}
   Works with the different versions of Strapi.
   :::