docs: edits to building pages entry - work in progress

Author: backlineint

www/content/docs/pages.mdx

@@ -3,23 +3,10 @@ title: Building Pages
 excerpt: How to build pages using JSON:API resources from Drupal.
 ---
 
-In Next.js V14, data fetching has evolved significantly from previous versions. Instead of using `getStaticProps` and `getServerSideProps` you now use the native `fetch` function enhanced by Next.js to handle server-side data fetching.
-
-The `NextDrupal` client provides several functions to help you query JSON:API resources from Drupal.
-
-<!--
-************************************************************
-*  TODO: Remove this block before publishing.
-
-*  Comment: Need to corroborate (and maybe update) once next-drupal supports `next` revalidation options. Possible replacement for above introduction once it's supported
-
-In Next.js V14, data fetching has evolved significantly from previous versions. Instead of using `getStaticProps` and `getServerSideProps` you now use the native `fetch` function enhanced by Next.js to handle server-side data fetching. This allows you to configure caching and revalidation directly within your fetch requests. These can be used in Server Components, Route Handlers, and Server Actions. You can read more about it [here](https://nextjs.org/docs/app/building-your-application/data-fetching/fetching-caching-and-revalidating)
+In Next.js V14, data fetching has evolved significantly from previous versions. Instead of using `getStaticProps` and `getServerSideProps` you now use the native `fetch` function enhanced by Next.js to handle server-side data fetching. This also allows you to configure caching and revalidation directly within your fetch requests. These can be used in Server Components, Route Handlers, and Server Actions. You can read more about it [here](https://nextjs.org/docs/app/building-your-application/data-fetching/fetching-caching-and-revalidating).
 
 The `NextDrupal` client provides several functions to help you query JSON:API resources from Drupal and manage these revalidation options on the `fetch` request level.
 
-************************************************************
--->
-
 ---
 
 ## Basic Example
@@ -53,6 +40,8 @@ export default function AboutPage() {
 }
 ```
 
+TODO - time based revalidation.
+
 ---
 
 ## Dynamic pages
@@ -156,10 +145,12 @@ export default function Page({ params }) {
 }
 ```
 
+TODO - tag based revalidation.
+
 ## Reference
 
 See the [fetching JSON:API resources](/docs/fetching-resources) section for more examples of fetching resources and collection of resources.
 
 ## Pages Router
 
-TODO
+TODO - Port some examples from the previous docs.

www/pages/index.tsx

@@ -34,7 +34,8 @@ export default function IndexPage({ features }: IndexPageProps) {
 
   return (
     <Layout title={site.name} description={site.description}>
-      TODO - Re-order elements on home page
+      TODO - Re-order elements on home page TODO - A Last docs wide search for
+      'TODO'
       <section className="relative px-6 pt-12 pb-8 md:py-12 md:pb-8">
         <div className="container max-w-4xl mx-auto text-center">
           <Link