Cookbook renovation (#26885)

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-07 22:04:54 -07:00
parent 6365d6faee
commit d1777d1f6d
16 changed files with 6692 additions and 1693 deletions
@@ -0,0 +1,109 @@
+name: 🧪 Playground - Verified Cell Submission
+description: Submit a deployment recipe you verified in the cookbook Playground. A maintainer will review and promote it into the cell catalog via PR.
+title: "[Playground] Verified cell: <fill from playground>"
+labels: ["cookbook", "playground-submission"]
+
+body:
+- type: markdown
+  attributes:
+    value: |
+      Thanks for verifying a deployment recipe!
+
+      The cookbook **Playground** section of each model page pre-fills this
+      form. When your overrides diverge from the verified cell, click
+      **Submit ↗**, confirm the SGLang version / benchmark / notes in the
+      **Submit verified cell** dialog and tick the attestations, then
+      **Open submission on GitHub →**. The model, combination, proposed cell
+      snippet, and existing cell are filled automatically — please double-check
+      the snippet matches what you ran.
+
+      Once a maintainer with access to the listed hardware reproduces the
+      recipe, they'll convert this issue into a PR against the cookbook cell
+      catalog and close this issue.
+
+- type: dropdown
+  id: model
+  attributes:
+    label: Cookbook model
+    description: Which model's cookbook does this cell belong to?
+    options:
+      - deepseek-ai/deepseek-v4
+  validations:
+    required: true
+
+- type: input
+  id: combination
+  attributes:
+    label: Combination
+    description: "Format: hw / variant / quant / strategy / nodes (auto-filled by the playground)."
+    placeholder: "b200 / flash / fp4 / low-latency / single"
+  validations:
+    required: true
+
+- type: textarea
+  id: cell-snippet
+  attributes:
+    label: Proposed cell snippet
+    description: |
+      The cell object exactly as it should land in the `cells: [...]` array
+      of the cookbook config. Auto-generated by the playground — please do not
+      hand-edit unless you're sure.
+    render: javascript
+  validations:
+    required: true
+
+- type: textarea
+  id: existing-cell
+  attributes:
+    label: Existing cell at this match (for diff)
+    description: |
+      The current verified cell at the same `match` tuple, if any. The
+      playground fills this so the maintainer can see exactly what changed.
+      Leave empty if no cell yet exists at this match.
+    render: javascript
+  validations:
+    required: false
+
+- type: input
+  id: sglang-version
+  attributes:
+    label: SGLang version
+    description: Version, tag, or git SHA you tested against.
+    placeholder: "sglang==0.5.4  (or git SHA abc1234)"
+  validations:
+    required: true
+
+- type: textarea
+  id: bench-result
+  attributes:
+    label: Benchmark result (optional but encouraged)
+    description: |
+      One-line perf numbers (TTFT, TPOT, tokens/sec, accepted-rate, etc.).
+      Helps maintainers decide whether this recipe should replace the
+      existing one or be added as an alternative.
+    placeholder: "TTFT 95 ms / TPOT 18 ms / 1820 tok/s @ bs=64"
+  validations:
+    required: false
+
+- type: textarea
+  id: notes
+  attributes:
+    label: Notes / caveats
+    description: |
+      Anything unusual: cluster config, env-var quirks, NIC mappings,
+      multi-node bootstrap details, etc.
+  validations:
+    required: false
+
+- type: checkboxes
+  id: attestation
+  attributes:
+    label: Attestation
+    description: All three must be ticked. We trust contributors but maintainers will still re-verify before merging.
+    options:
+      - label: I ran this exact command on the listed hardware.
+        required: true
+      - label: The server reached READY and answered a cURL request successfully.
+        required: true
+      - label: Output looked correct on at least one prompt.
+        required: true