feat: update menu strucutre and mark areas in docs that need to be expanded for Pages router

Author: backlineint

www/config/docs.ts

@@ -34,7 +34,7 @@ export const docsConfig: DocsConfig = {
       ],
     },
     {
-      title: "Drupal Client",
+      title: "NextDrupal Client",
       items: [
         {
           title: "Introduction",
@@ -94,6 +94,10 @@ export const docsConfig: DocsConfig = {
           title: "Advanced Example",
           href: "/docs/pages#advanced-example",
         },
+        {
+          title: "Pages Router",
+          href: "/docs/pages#pages-router",
+        },
       ],
     },
     {
@@ -196,6 +200,10 @@ export const docsConfig: DocsConfig = {
           title: "getAuthorizationHeader",
           href: "/docs/reference/getauthorizationheader",
         },
+        {
+          title: "Pages Router",
+          href: "/docs/reference/pages-router",
+        },
       ],
     },
     {

www/config/site.ts

@@ -44,12 +44,16 @@ export const site: SiteConfig = {
   },
   versions: [
     {
-      version: "v1.6.0",
+      version: "v2.0.0",
       active: true,
     },
     {
-      version: "v1.0.0",
+      version: "v1.6.0",
       url: "https://v1.next-drupal.org",
     },
+    {
+      version: "canary",
+      url: "https://next.next-drupal.org",
+    },
   ],
 }

www/content/blog/next-drupal-2-0.mdx

@@ -0,0 +1,10 @@
+---
+title: Next-Drupal 2.0
+author: brianperry
+date: October 31, 2024
+created: "2024-10-31"
+excerpt: Next.js 14, Drupal 11 and App Router Support.
+published: true
+---
+
+Write this post.

www/content/docs/client.mdx

@@ -26,6 +26,8 @@ It also comes with full support for JSON:API write operations which means you ca
 
 ## Usage
 
+### App Router
+
 ```ts
 import { NextDrupal } from "next-drupal"
 
@@ -41,3 +43,7 @@ const article = await drupal.getResource(
   "f4c61473-8297-4bf3-bab7-21c9633a7ca7"
 )
 ```
+
+### Pages Router
+
+TODO

www/content/docs/configuration.mdx

@@ -5,6 +5,8 @@ excerpt: Initialization and options for NextDrupal client.
 
 ## Initialization
 
+### App Router
+
 To create a new `NextDrupal` client, use the following initialization:
 
 ```ts
@@ -19,6 +21,8 @@ Where `NEXT_PUBLIC_DRUPAL_BASE_URL` is the URL to your Drupal site defined as an
 NEXT_PUBLIC_DRUPAL_BASE_URL=http://example.com
 ```
 
+### Pages Router
+
 ---
 
 ## Options
@@ -226,3 +230,5 @@ JSON:API errors are thrown in non-production environments by default. The errors
 By default, the resource endpoint will be based on the resource name. If you turn this off, a JSON:API request will retrieve the resource's endpoint url.
 
 ---
+
+TODO - Call out any App Router or Pages Router specific options here.

www/content/docs/deserializer.mdx

@@ -29,3 +29,7 @@ export const drupal = new NextDrupal(process.env.NEXT_PUBLIC_DRUPAL_BASE_URL, {
   deserializer: customDeserializer,
 })
 ```
+
+### Pages Router
+
+TODO - the option was called serializer

www/content/docs/faq.mdx

@@ -7,6 +7,10 @@ excerpt: Frequently Asked Questions about Next.js for Drupal
 
 Next.js for Drupal works requires Drupal 9.3+ and Drupal 10.
 
+## Which Next.js versions are supported?
+
+Next.js for Drupal supports both Next.js 13 and Next.js 14. This includes support for both the App Router and the Pages Router.
+
 ## Does it work without authentication?
 
 Yes. Authentication is only required for previewing unpublished entities and revisions.

www/content/docs/pages.mdx

@@ -159,3 +159,7 @@ export default function Page({ params }) {
 ## Reference
 
 See the [fetching JSON:API resources](/docs/fetching-resources) section for more examples of fetching resources and collection of resources.
+
+## Pages Router
+
+TODO

www/content/docs/reference/pages-router.mdx

@@ -0,0 +1,9 @@
+---
+title: Pages Router
+excerpt: An index of methods specific to the Pages Router.
+---
+
+TODO
+
+- Link 1
+- Link 2

www/content/docs/upgrade-guide.mdx

@@ -3,6 +3,42 @@ title: Upgrade Guide
 excerpt: Guide for upgrading your site to use DrupalClient.
 ---
 
+## next-drupal 2.0.0
+
+1. Upgrade to the latest version
+
+```sh
+yarn add next-drupal@latest
+```
+
+<Callout>
+
+`next-drupal 2.0.0` adds support for the App Router and maintains support for the Pages Router. For information on transitioning from the Pages Router to the App Router, see the [App Router Incremental Adoption Guide](https://nextjs.org/docs/app/building-your-application/upgrading/app-router-migration) guide on the Next.js site.
+
+</Callout>
+
+TODO - Outline breaking changes here.
+
+## next 2.0.0
+
+1. Upgrade your Drupal site to use `next 2.0.0`
+
+```sh
+composer require drupal/next
+```
+
+2. Run updates:
+
+```sh
+drush updb
+```
+
+<Callout>
+
+TODO - Describe changes as that will occur as a result of this upgrade.
+
+</Callout>
+
 ## next-drupal 1.6.0
 
 1. Upgrade to the latest version