diff --git a/develop-docs/sdk/getting-started/index.mdx b/develop-docs/sdk/getting-started/index.mdx index 2f1e955187a171..c56dbe0c039482 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 f17959fe0ed292..f74bd43dd10635 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 00000000000000..7ffe0ca298cd43 --- /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 00000000000000..27d15871847bb3 --- /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 00000000000000..df975ea512f478 --- /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 00000000000000..a3f9328400623d --- /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 00000000000000..1e681a8d2c2509 --- /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 +---