fix(docs): update links, fix codeblocks, rephrase (#9566)

ndom91 · balazsorban44 · web-flow · commit 1b9ef7f1259b · 2024-01-07T01:39:30.000+01:00
Co-authored-by: Balázs Orbán &lt;info@balazsorban.com&gt;
diff --git a/docs/docs/reference/index.md b/docs/docs/reference/index.md
@@ -14,13 +14,13 @@ Here are the _state_ of planned and released packages under the `@auth/*` and `@
 | `next-auth`            | Released (v4). See [docs](https://next-auth.js.org)                                                                                                                                    |
 | `@auth/*-adapter`      | Released (stable). Fully compatible with `next-auth` and all `@auth/*` libraries.                                                                                                      |
 | `@next-auth/*-adapter` | Maintenance has stopped. Update to `@auth/*-adapter`. See above.                                                                                                                       |
-| `@auth/core`           | Released (experimental).                                                                                                                                                               |
-| `@auth/sveltekit`      | Released (experimental, [help needed](#help-needed)).                                                                                                                                  |
-| `@auth/solid-start`    | Released (experimental, [help needed](#help-needed)). Community package: [`@solid-mediakit/auth`](https://www.npmjs.com/package/@solid-mediakit/auth)                                  |
-| `@auth/express`        | Released (experimental, [help needed](#help-needed)).                                                                                                                         |
-| `@auth/remix`          | Planned, [help needed](#help-needed).                                                                                                                                                  |
-| `@auth/astro`          | Planned, [help needed](#help-needed).                                                                                                                                                  |
-| `@auth/nuxt`           | Planned, [help needed](#help-needed). Community packages: [`@sidebase/nuxt-auth`](https://github.com/sidebase/nuxt-auth), [`@hebilicious/authjs-nuxt`](https://authjs-nuxt.pages.dev/) |
+| `@auth/core`           | Released (experimental). See [docs](/reference/core)                                                                                                                                   |
+| `@auth/sveltekit`      | Released (experimental). See [docs](/reference/sveltekit)                                                                                                                              |
+| `@auth/solid-start`    | Released (experimental). See [docs](/reference/solidstart) Community package: [`@solid-mediakit/auth`](https://www.npmjs.com/package/@solid-mediakit/auth)                              |
+| `@auth/express`        | Released (experimental). See [docs](/reference/express)                                                                                                                                |
+| `@auth/remix`          | Planned.                                                                                                                                                                               |
+| `@auth/astro`          | Planned.                                                                                                                                                                               |
+| `@auth/nuxt`           | Planned. Community packages: [`@sidebase/nuxt-auth`](https://github.com/sidebase/nuxt-auth), [`@hebilicious/authjs-nuxt`](https://authjs-nuxt.pages.dev/)                              |
 
 :::info
 The NextAuth.js v4 documentation is at [next-auth.js.org](https://next-auth.js.org), while v5+ will be available [here](/reference/nextjs). Guides are being migrated over to the new documentation page and are gradually being updated to showcase all the framework integrations.
diff --git a/packages/frameworks-express/src/index.ts b/packages/frameworks-express/src/index.ts
@@ -8,7 +8,7 @@
  * It provides a simple way to add authentication to your Express app in a few lines of code.
  *
  * ## Installation
- * ```bash npm2yarn2pnpm
+ * ```bash npm2yarn
  * npm install @auth/express
  * ```
  *
@@ -43,7 +43,7 @@
  *
  * Don't forget to set the `AUTH_SECRET` environment variable. This should be a minimum of 32 characters, random string. On UNIX systems you can use `openssl rand -hex 32` or check out `https://generate-secret.vercel.app/32`.
  *
- * You will also need to load the environment variables into the Node.js environment. You can do this using a package like [`dotenv`](https://www.npmjs.com/package/dotenv).
+ * You will also need to load the environment variables into your runtime environment. For example in Node.js with a package like [`dotenv`](https://www.npmjs.com/package/dotenv) or `Deno.env` in Deno.
  *
  * ### Provider Configuration
  * The callback URL used by the [providers](https://authjs.dev/reference/core/modules/providers) must be set to the following, unless you mount the `ExpressAuth` handler on a different path:
@@ -53,7 +53,7 @@
  * ```
  *
  * ## Signing in and signing out
- * Once your application is mounted you can sign in or out by making requests to the following [REST API endpoints](https://next-auth.js.org/getting-started/rest-api) from your client-side code.
+ * Once your application is mounted you can sign in or out by making requests to the following [REST API endpoints](https://authjs.dev/reference/core/types#authaction) from your client-side code.
  * NB: Make sure to include the `csrfToken` in the request body for all sign-in and sign-out requests.
  *
  * ## Managing the session
@@ -135,12 +135,6 @@
  * app.use("/protected", protected)
  * ```
  *
- * ## Notes
- *
- * :::info
- * PRs to improve this documentation are welcome! See [this file](https://github.com/nextauthjs/next-auth/blob/main/packages/frameworks-express/src/lib/index.ts).
- * :::
- *
  * @module @auth/express
  */
 

Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`	`* It provides a simple way to add authentication to your Express app in a few lines of code.`
`9`	`9`	`*`
`10`	`10`	`* ## Installation`
`11`		- * ```bash npm2yarn2pnpm
	`11`	+ * ```bash npm2yarn
`12`	`12`	`* npm install @auth/express`
`13`	`13`	* ```
`14`	`14`	`*`
`@@ -43,7 +43,7 @@`
`43`	`43`	`*`
`44`	`44`	* Don't forget to set the `AUTH_SECRET` environment variable. This should be a minimum of 32 characters, random string. On UNIX systems you can use `openssl rand -hex 32` or check out `https://generate-secret.vercel.app/32`.
`45`	`45`	`*`
`46`		- * You will also need to load the environment variables into the Node.js environment. You can do this using a package like [`dotenv`](https://www.npmjs.com/package/dotenv).
	`46`	+ * You will also need to load the environment variables into your runtime environment. For example in Node.js with a package like [`dotenv`](https://www.npmjs.com/package/dotenv) or `Deno.env` in Deno.
`47`	`47`	`*`
`48`	`48`	`* ### Provider Configuration`
`49`	`49`	* The callback URL used by the [providers](https://authjs.dev/reference/core/modules/providers) must be set to the following, unless you mount the `ExpressAuth` handler on a different path:
`@@ -53,7 +53,7 @@`
`53`	`53`	* ```
`54`	`54`	`*`
`55`	`55`	`* ## Signing in and signing out`
`56`		`- * Once your application is mounted you can sign in or out by making requests to the following [REST API endpoints](https://next-auth.js.org/getting-started/rest-api) from your client-side code.`
	`56`	`+ * Once your application is mounted you can sign in or out by making requests to the following [REST API endpoints](https://authjs.dev/reference/core/types#authaction) from your client-side code.`
`57`	`57`	* NB: Make sure to include the `csrfToken` in the request body for all sign-in and sign-out requests.
`58`	`58`	`*`
`59`	`59`	`* ## Managing the session`
`@@ -135,12 +135,6 @@`
`135`	`135`	`* app.use("/protected", protected)`
`136`	`136`	* ```
`137`	`137`	`*`
`138`		`- * ## Notes`
`139`		`- *`
`140`		`- * :::info`
`141`		`- * PRs to improve this documentation are welcome! See [this file](https://github.com/nextauthjs/next-auth/blob/main/packages/frameworks-express/src/lib/index.ts).`
`142`		`- * :::`
`143`		`- *`
`144`	`138`	`* @module @auth/express`
`145`	`139`	`*/`
`146`	`140`