feat: Add auto generated next steps to PHP (#2386)

- Add nextPages and header attributes to PageGrid
- Add sidebar_order to all sections
- Add descriptions for various pages

Co-authored-by: Fiona <[email protected]>

Author: dcramer

src/components/pageGrid.tsx

@@ -20,34 +20,51 @@ const query = graphql`
   }
 `;
 
-export default (): JSX.Element => {
+type Props = {
+  nextPages: boolean;
+  header?: string;
+};
+
+export default ({ nextPages = false, header }: Props): JSX.Element => {
   const data = useStaticQuery(query);
   const location = useLocation();
 
   const currentPath = location.pathname;
   const currentPathLen = currentPath.length;
 
-  const matches = sortPages(
+  let matches = sortPages(
     data.allSitePage.nodes.filter(
       n =>
         n.context &&
         n.context.title &&
-        n.path !== currentPath &&
         n.path.indexOf(currentPath) === 0 &&
         n.path.slice(currentPathLen).split("/", 2)[1] === ""
     )
   );
 
+  if (nextPages) {
+    matches = matches.slice(
+      matches.indexOf(matches.find(n => n.path === currentPath))
+    );
+  } else {
+    matches = matches.filter(n => n.path !== currentPath);
+  }
+
+  if (!matches.length) return null;
+
   return (
-    <ul>
-      {matches.map(n => (
-        <li key={n.path} style={{ marginBottom: "1rem" }}>
-          <h4 style={{ marginBottom: 0 }}>
-            <SmartLink to={n.path}>{n.context.title}</SmartLink>
-          </h4>
-          {n.context.description ?? <p>{n.context.description}</p>}
-        </li>
-      ))}
-    </ul>
+    <nav>
+      {header && <h2>{header}</h2>}
+      <ul>
+        {matches.map(n => (
+          <li key={n.path} style={{ marginBottom: "1rem" }}>
+            <h4 style={{ marginBottom: 0 }}>
+              <SmartLink to={n.path}>{n.context.title}</SmartLink>
+            </h4>
+            {n.context.description ?? <p>{n.context.description}</p>}
+          </li>
+        ))}
+      </ul>
+    </nav>
   );
 };

src/docs/contributing/pages/components.mdx

@@ -117,6 +117,11 @@ Render all child pages of this document, including their `description` if availa
 <PageGrid />
 ```
 
+Attributes:
+
+- `header` (string) - optional header value to include, rendered as an H2
+- `nextPages` (boolean) - only render pages which come next based on sidebar ordering
+
 ## PlatformContent
 
 Render an include based on the currently selected `platform` in context.

src/platforms/common/configuration/index.mdx

@@ -1,6 +1,8 @@
 ---
 title: Configuration
-notSupported: ["native.ue4", "native.breakpad", "native.crashpad", "native.minidumps"]
+notSupported:
+  ["native.ue4", "native.breakpad", "native.crashpad", "native.minidumps"]
+description: Additional configuration options for the SDK.
 sidebar_order: 5
 ---
 

src/platforms/common/data-management/index.mdx

@@ -1,5 +1,7 @@
 ---
 title: Data Management
+sidebar_order: 4000
+description: Manage your events by applying pre-filtering, scrubbing sensitive information, and forwarding them other systems.
 ---
 
 <PageGrid />

src/platforms/common/enriching-events/index.mdx

@@ -1,5 +1,7 @@
 ---
 title: Enriching Events
+sidebar_order: 3000
+description: Enrich events with additional context to make debugging simpler.
 notSupported:
   - native.breakpad
   - native.crashpad

src/platforms/common/usage/index.mdx

@@ -2,7 +2,7 @@
 title: Usage
 sidebar_order: 10
 excerpt: ""
-description: "Learn more about automatically reporting errors, exceptions, and rejections as well as how to manually capture errors and enable message capture."
+description: "Use the SDK to manually capture errors and other events."
 notSupported:
   - native.breakpad
   - native.crashpad

src/platforms/javascript/index.mdx

@@ -128,6 +128,8 @@ Learn more about sampling in [Filtering Events Reported to Sentry](configuration
 
 ## Next Steps
 
+<PageGrid nextSteps />
+
 - **[Manage Configuration Options](./configuration/)**
 
   Sentry's JavaScript SDK includes many configuration options that are automatically set. You can configure your SDK using the options outlined in these pages.

src/platforms/php/common/default-integrations.mdx

@@ -1,6 +1,8 @@
 ---
 title: Default Integrations
-sidebar_order: 1000
+description: "Default integrations are integrations enabled by default that integrate into the
+standard library or the interpreter itself."
+sidebar_order: 500
 ---
 
 Default integrations are integrations enabled by default that integrate into the

src/platforms/php/common/performance.mdx

@@ -1,5 +1,6 @@
 ---
 title: Performance
+sidebar_order: 2000
 description: "Configure our Performance Monitoring integration to suit the needs of your organization. You can use the Performance Monitoring homepage to search or browse for transaction data."
 ---
 
@@ -94,10 +95,10 @@ You can also use this to filter for specific conditions when you don't want to s
 
 ```php
 $transaction = SentrySdk::getCurrentHub()->getTransaction();
-            
+
 if ($transaction instanceof Transaction) {
     // $transaction->setSampled(false); // __DONT__ SEND TRANSACTION
-    // $transaction->setSampled(true); // __DO__ SEND TRANSACTION  
+    // $transaction->setSampled(true); // __DO__ SEND TRANSACTION
 }
 ```
 
@@ -131,4 +132,4 @@ Add the following line to your blade template rendering the `<head/>` of your pa
 
 This helper function will render a meta tag similar to this `<meta name="sentry-trace" content="49879feb76c84743ba5034bd2d3f1ca3-7cb5535c930d4666-1"/>` which our JS SDK will pick up and continue the trace. Therefore your frontend and your backend are connected via the same trace.
 
-</PlatformSection>
+</PlatformSection>

src/platforms/php/index.mdx

@@ -68,3 +68,5 @@ Sentry\init([
 Performance data is transmitted using a new event type called "transactions", which you can learn about in [Distributed Tracing](/performance-monitoring/distributed-tracing/#traces-transactions-and-spans). **To capture transactions, you must install and configure your SDK to set the `traces_sample_rate` option to a nonzero value.** The example configuration above will transmit 100% of captured traces. Be sure to lower this value in production otherwise you could burn through your quota quickly.
 
 Learn more about sampling in [Using Your SDK to Filter Events](configuration/filtering/).
+
+<PageGrid header="Next Steps" nextSteps />