feat: add logic for adding next page

Author: chargome

app/[[...path]]/page.tsx

@@ -13,6 +13,7 @@ import {PlatformContent} from 'sentry-docs/components/platformContent';
 import {
   getCurrentPlatformOrGuide,
   getDocsRootNode,
+  getNextNode,
   nodeForPath,
 } from 'sentry-docs/docTree';
 import {isDeveloperDocs} from 'sentry-docs/isDeveloperDocs';
@@ -42,7 +43,11 @@ export const dynamic = 'force-static';
 
 const mdxComponentsWithWrapper = mdxComponents(
   {Include, PlatformContent},
-  ({children, frontMatter}) => <DocPage frontMatter={frontMatter}>{children}</DocPage>
+  ({children, frontMatter, nextPage}) => (
+    <DocPage frontMatter={frontMatter} nextPage={nextPage}>
+      {children}
+    </DocPage>
+  )
 );
 
 function MDXLayoutRenderer({mdxSource, ...rest}) {
@@ -95,6 +100,10 @@ export default async function Page({params}: {params: {path?: string[]}}) {
   }
 
   const pageNode = nodeForPath(rootNode, params.path);
+  const nextNode = pageNode ? getNextNode(pageNode) : undefined;
+  const nextPage = nextNode
+    ? {path: nextNode.path, title: nextNode.frontmatter.title}
+    : undefined;
 
   if (!pageNode) {
     // eslint-disable-next-line no-console
@@ -122,7 +131,11 @@ export default async function Page({params}: {params: {path?: string[]}}) {
 
   // pass frontmatter tree into sidebar, rendered page + fm into middle, headers into toc.
   return (
-    <MDXLayoutRenderer mdxSource={mdxSource} frontMatter={{...frontMatter, versions}} />
+    <MDXLayoutRenderer
+      mdxSource={mdxSource}
+      frontMatter={{...frontMatter, versions}}
+      nextPage={nextPage}
+    />
   );
 }
 

docs/account/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: Account Settings
-sidebar_order: 400
+sidebar_order: 10
 description: "Learn about Sentry's user settings and auth tokens."
 ---
 

docs/api/index.mdx

@@ -1,5 +1,6 @@
 ---
 title: API Reference
+sidebar_order: 60
 ---
 
 The Sentry web API is used to access the Sentry platform programmatically. You can use the APIs to manage account-level resources, like organizations and teams, as well as manage and export data.

docs/cli/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Sentry CLI"
-sidebar_order: 4000
+sidebar_order: 50
 keywords:
   [
     "cli",

docs/concepts/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: Concepts & Reference
-sidebar_order: 160
+sidebar_order: 80
 description: "Learn the basic concepts of Sentry such as searchable properties and data management settings."
 ---
 

docs/organization/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: Organization Settings
-sidebar_order: 400
+sidebar_order: 20
 description: "Learn how to configure your organization's Sentry account, including 2FA authentication, user management, and data storage location."
 ---
 

docs/pricing/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: Pricing & Billing
-sidebar_order: 1
+sidebar_order: 40
 description: "Learn about pricing, managing volume, and the different Sentry plans."
 ---
 

docs/product/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: Product Walkthroughs
-sidebar_order: 1
+sidebar_order: 30
 description: "Get an overview of how you can use Sentry to not just observe, but debug errors, get to the root of user complaints, and identify performance bottlenecks."
 ---
 

docs/security-legal-pii/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: Security, Legal, & PII
-sidebar_order: 1
+sidebar_order: 70
 description: "Learn about Sentry's security and compliance processes and how to scrub sensitive data."
 ---
 

src/docTree.spec.ts

@@ -1,6 +1,14 @@
 import {describe, expect, test} from 'vitest';
 
-import {DocNode, getCurrentPlatformOrGuide, nodeForPath} from './docTree';
+import {
+  DocNode,
+  getCurrentPlatformOrGuide,
+  getNextNode,
+  isRootGuidePath,
+  isRootPlatformPath,
+  nodeForPath,
+} from './docTree';
+import {FrontMatter} from './types';
 
 const createRootNode = (): DocNode => ({
   children: [],
@@ -11,6 +19,19 @@ const createRootNode = (): DocNode => ({
   sourcePath: '',
 });
 
+const createNode = (path: string, title: string, frontmatter?: FrontMatter): DocNode => ({
+  children: [],
+  frontmatter: {
+    title,
+    slug: path,
+    ...frontmatter,
+  },
+  missing: false,
+  path,
+  slug: path,
+  sourcePath: 'sourcepath',
+});
+
 const nextjsRoot = createRootNode();
 nextjsRoot.children = [
   {
@@ -119,4 +140,101 @@ describe('docTree', () => {
       expect(node?.name).toBe('javascript');
     });
   });
+
+  describe('getNextNode', () => {
+    const rootNode = createRootNode();
+
+    const nodeWithChildren = createNode('a', 'A');
+    nodeWithChildren.children = [createNode('a1', 'A1'), createNode('a2', 'A2')];
+    nodeWithChildren.children.forEach(child => {
+      child.parent = nodeWithChildren;
+    });
+
+    rootNode.children = [nodeWithChildren, createNode('b', 'B'), createNode('c', 'C')];
+    rootNode.children.forEach(child => {
+      child.parent = rootNode;
+    });
+
+    test('should return first child for root node', () => {
+      const nextNode = getNextNode(rootNode);
+      expect(nextNode?.slug).toBe('a');
+    });
+
+    test('should return first child for node with children', () => {
+      const nextNode = getNextNode(nodeWithChildren);
+      expect(nextNode?.slug).toBe('a1');
+    });
+
+    test('should return next sibling', () => {
+      const nextNode = getNextNode(nodeWithChildren.children[0]);
+      expect(nextNode?.slug).toBe('a2');
+    });
+
+    test('should return sibling of parent if no siblings available', () => {
+      const nextNode = getNextNode(nodeWithChildren.children[1]);
+      expect(nextNode?.slug).toBe('b');
+    });
+
+    test('should return undefined if no children or siblings', () => {
+      const nextNode = getNextNode(createNode('d', 'D'));
+      expect(nextNode).toBeUndefined();
+    });
+
+    test('should respect sidebar order for sorting', () => {
+      const root = createRootNode();
+      const a = createNode('a', 'A', {sidebar_order: 2} as FrontMatter);
+      const b = createNode('b', 'B', {sidebar_order: 1} as FrontMatter);
+      root.children = [a, b];
+      root.children.forEach(child => {
+        child.parent = root;
+      });
+
+      const a1 = createNode('a1', 'A1', {sidebar_order: 2} as FrontMatter);
+      const a2 = createNode('a2', 'A2', {sidebar_order: 1} as FrontMatter);
+      a.children = [a1, a2];
+      a.children.forEach(child => {
+        child.parent = a;
+      });
+
+      expect(getNextNode(a)?.slug).toBe('a2');
+      expect(getNextNode(b)?.slug).toBe('a');
+      expect(getNextNode(a1)?.slug).toBeUndefined();
+    });
+
+    test('should not return siblings for root platform or guide paths', () => {
+      expect(
+        getNextNode(createNode('platforms/javascript', 'JavaScript'))
+      ).toBeUndefined();
+      expect(
+        getNextNode(createNode('platforms/javascript/guides/nextjs', 'Next.js'))
+      ).toBeUndefined();
+    });
+  });
+
+  describe('isRootPlatformPath', () => {
+    test('should return true for root platform path', () => {
+      expect(isRootPlatformPath('platforms/javascript')).toBe(true);
+      expect(isRootPlatformPath('platforms/python')).toBe(true);
+    });
+
+    test('should return false for non-root platform path', () => {
+      expect(isRootPlatformPath('platforms/javascript/guides/nextjs')).toBe(false);
+      expect(isRootPlatformPath('platforms/javascript/troubleshooting')).toBe(false);
+    });
+  });
+
+  describe('isRootGuidePath', () => {
+    test('should return true for root guide path', () => {
+      expect(isRootGuidePath('platforms/javascript/guides/nextjs')).toBe(true);
+      expect(isRootGuidePath('platforms/python/guides/django')).toBe(true);
+    });
+
+    test('should return false for non-root guide path', () => {
+      expect(isRootGuidePath('platforms/javascript')).toBe(false);
+      expect(isRootGuidePath('platforms/javascript/troubleshooting/get-started')).toBe(
+        false
+      );
+      expect(isRootGuidePath('platforms/python/guides/django/installation')).toBe(false);
+    });
+  });
 });