From 0ad6e99c6f0e61a3f41a44c4632fbc2fa360bb97 Mon Sep 17 00:00:00 2001 From: Stephanie Anderson Date: Tue, 17 Feb 2026 23:03:28 +0100 Subject: [PATCH] docs(sdk): Reorganize getting-started section and add new categories Replace manual section listing with PageGrid, update philosophy description, and add placeholder sections for playbooks, standards, skills, and templates. Co-Authored-By: Claude --- develop-docs/sdk/getting-started/index.mdx | 8 +------- develop-docs/sdk/getting-started/philosophy/index.mdx | 2 +- develop-docs/sdk/getting-started/playbooks/index.mdx | 7 +++++++ develop-docs/sdk/getting-started/skills/index.mdx | 7 +++++++ develop-docs/sdk/getting-started/standards/index.mdx | 7 +++++++ develop-docs/sdk/getting-started/templates/index.mdx | 7 +++++++ .../sdk/getting-started/templates/saved-replies/index.mdx | 5 +++++ 7 files changed, 35 insertions(+), 8 deletions(-) create mode 100644 develop-docs/sdk/getting-started/playbooks/index.mdx create mode 100644 develop-docs/sdk/getting-started/skills/index.mdx create mode 100644 develop-docs/sdk/getting-started/standards/index.mdx create mode 100644 develop-docs/sdk/getting-started/templates/index.mdx create mode 100644 develop-docs/sdk/getting-started/templates/saved-replies/index.mdx diff --git a/develop-docs/sdk/getting-started/index.mdx b/develop-docs/sdk/getting-started/index.mdx index 2f1e955187a17..c56dbe0c03948 100644 --- a/develop-docs/sdk/getting-started/index.mdx +++ b/develop-docs/sdk/getting-started/index.mdx @@ -4,10 +4,4 @@ description: The following content provides guidance for SDK development at Sent sidebar_order: 1 --- -## Philosophy - -The [values](philosophy/) that shape what we build. Why SDKs exist, what makes a good one, and the design tradeoffs we navigate — trust, compatibility, minimalism, and user impact. - -## Principles - -Working [principles](principles/) for how we collaborate, review, and ship. They translate philosophy into daily decisions: who owns what, when to automate vs. judge, and why small PRs beat big ones. + diff --git a/develop-docs/sdk/getting-started/philosophy/index.mdx b/develop-docs/sdk/getting-started/philosophy/index.mdx index f17959fe0ed29..f74bd43dd1063 100644 --- a/develop-docs/sdk/getting-started/philosophy/index.mdx +++ b/develop-docs/sdk/getting-started/philosophy/index.mdx @@ -1,6 +1,6 @@ --- title: Philosophy -description: The values that shape what we build. Why SDKs exist, what makes a good one, and the design tradeoffs we navigate — trust, compatibility, minimalism, and user impact. +description: The values that shape what we build - what makes a good SDK and the design tradeoffs we navigate around trust, compatibility, minimalism, and user impact. sidebar_order: 2 --- diff --git a/develop-docs/sdk/getting-started/playbooks/index.mdx b/develop-docs/sdk/getting-started/playbooks/index.mdx new file mode 100644 index 0000000000000..7ffe0ca298cd4 --- /dev/null +++ b/develop-docs/sdk/getting-started/playbooks/index.mdx @@ -0,0 +1,7 @@ +--- +title: Playbooks +description: Step-by-step workflows for common scenarios. Each references the standards it operationalizes. +sidebar_order: 4 +--- + + diff --git a/develop-docs/sdk/getting-started/skills/index.mdx b/develop-docs/sdk/getting-started/skills/index.mdx new file mode 100644 index 0000000000000..27d15871847bb --- /dev/null +++ b/develop-docs/sdk/getting-started/skills/index.mdx @@ -0,0 +1,7 @@ +--- +title: Skills +description: Skills are reusable automation tools and procedures that help SDK teams enforce standards, streamline tasks, and maintain cross-SDK consistency. +sidebar_order: 5 +--- + + diff --git a/develop-docs/sdk/getting-started/standards/index.mdx b/develop-docs/sdk/getting-started/standards/index.mdx new file mode 100644 index 0000000000000..df975ea512f47 --- /dev/null +++ b/develop-docs/sdk/getting-started/standards/index.mdx @@ -0,0 +1,7 @@ +--- +title: Standards +description: Enforceable rules, each with a defined automation/enforcement mechanism. Cross-SDK baseline with per-SDK overrides. +sidebar_order: 3 +--- + + diff --git a/develop-docs/sdk/getting-started/templates/index.mdx b/develop-docs/sdk/getting-started/templates/index.mdx new file mode 100644 index 0000000000000..a3f9328400623 --- /dev/null +++ b/develop-docs/sdk/getting-started/templates/index.mdx @@ -0,0 +1,7 @@ +--- +title: Templates +description: Shared resources used to standardize key documentation and process patterns across all SDK repos. +sidebar_order: 6 +--- + + diff --git a/develop-docs/sdk/getting-started/templates/saved-replies/index.mdx b/develop-docs/sdk/getting-started/templates/saved-replies/index.mdx new file mode 100644 index 0000000000000..1e681a8d2c250 --- /dev/null +++ b/develop-docs/sdk/getting-started/templates/saved-replies/index.mdx @@ -0,0 +1,5 @@ +--- +title: GitHub Saved Replies +description: GitHub saved replies for common scenarios. These are team-approved responses - using them is expected and encouraged. +sidebar_order: 30 +---