Develop sdks (#11701)

Author: stephanie-anderson

develop-docs/sdk/expected-features/index.mdx

@@ -1,11 +1,13 @@
 ---
-title: Expected Features
+title: Features
+description: The following is a description of features that are commonly expected in Sentry SDKs.
 sidebar_order: 4
 ---
 
-The following is a description of features that are commonly expected in Sentry SDKs.  Make sure to also
-have read the <Link to="/sdk/miscellaneous/unified-api">unified API design</Link> documentation
-which explains the common API design.
+<Alert title="Unified API" level="warning">
+  Make sure to also have read the <Link to="/sdk/miscellaneous/unified-api">unified API</Link> documentation
+  which explains the common API design.
+</Alert>
 
 ## Background Sending
 

develop-docs/sdk/index.mdx

@@ -3,17 +3,4 @@ title: SDK Development
 sidebar_order: 60
 ---
 
-The following is a guide for implementing a Sentry SDK.
-
-It covers the protocol for event submission as well as guidelines for how clients should
-typically look and behave.
-
-- <Link to="/sdk/overview/">Overview</Link>
-- <Link to="/sdk/philosophy/">Philosophy and Design Principles</Link>
-- <Link to="/sdk/development-process/">Development Process</Link>
-- <Link to="/sdk/expected-features/">Expected Features</Link>
-- <Link to="/sdk/telemetry/">Telemetry</Link>
-- <Link to="/sdk/data-model/">Data Model</Link>
-- <Link to="/sdk/javascript-sdks/">Javascript SDKs</Link>
-- <Link to="/sdk/native-sdks/">Native SDKs</Link>
-- <Link to="/sdk/serverless-sdks/">Serverless SDKs</Link>
+<PageGrid />

develop-docs/sdk/miscellaneous/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: Miscellaneous
-sidebar_order: 10
+sidebar_order: 100
 ---
 
 <PageGrid />

develop-docs/sdk/overview.mdx

@@ -1,10 +1,9 @@
 ---
 title: Overview
+description: The following is a guide for implementing a new Sentry SDK. It covers the protocol for event submission as well as guidelines for how clients should typically look and behave.
 sidebar_order: 1
 ---
 
-The following is a guide for implementing a new Sentry SDK. It covers the protocol for event submission as well as guidelines for how clients should typically look and behave.
-
 ## Writing an SDK
 
 At its core an SDK is a set of utilities for capturing data about an exceptional state in an application. Given this data, it then builds and sends a JSON payload to the Sentry server.

develop-docs/sdk/philosophy.mdx

@@ -1,9 +1,9 @@
 ---
 title: Philosophy
+description: This document provides general guidance for SDK development at Sentry. It aims to help both internal and external developers understand the motivations behind SDK design decisions and our decision-making process.
 sidebar_order: 2
 ---
 
-This document sets some general guidance for how to approach SDK development at Sentry. It should aid both internal and external developers to understand what motivations go into the design of the SDKs and why we're deciding in certain ways.
 
 ## Trust is #1
 

develop-docs/sdk/platform-specifics/index.mdx

@@ -0,0 +1,7 @@
+---
+title: Platform Specifics
+description: Read more about the specifics when it comes to certain SDKs.
+sidebar_order: 99
+---
+
+<PageGrid />