Skip to content

docs: add DSpark backbone and long-context recipes - #740

Closed
Boreas618 wants to merge 3 commits into
sgl-project:mainfrom
Boreas618:agent/dspark-recipe-docs
Closed

docs: add DSpark backbone and long-context recipes#740
Boreas618 wants to merge 3 commits into
sgl-project:mainfrom
Boreas618:agent/dspark-recipe-docs

Conversation

@Boreas618

Copy link
Copy Markdown
Contributor

What changed

  • Adds practical DSpark draft-backbone sizing guidance: target-matched GQA, uniform target taps, FFN/depth tradeoffs, serving constraints, block-size alignment, and objective defaults.
  • Adds a two-stage native-RoPE to YaRN training recipe for long-context draft adaptation.
  • Links both pages from the documentation navigation.

Why

The Inkling-Small v2 program exposed repeatable design and operational rules that are useful when adapting DSpark/DFlash to a new target. These rules were previously captured only in an old development branch.

Impact

Users get concrete, reviewable guidance for choosing a draft architecture and adapting it to long contexts without training every stage at the maximum sequence length.

Validation

  • git diff --check upstream/main...HEAD
  • make -C docs html SPHINXOPTS='-W --keep-going' reads and renders both new pages successfully; the command exits nonzero on the pre-existing docs/basic_usage/training.md:19 header-level warning.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

Boreas618 and others added 3 commits August 1, 2026 17:32
Sizing rules validated by the Inkling-Small v2 program: target-matched
GQA geometry, uniform target taps, FFN width over depth, serve-ability
constraints on the attention pattern, train-block = serve-block with
block-size-adapted loss decay, and the constant-LR schedule.
Native-context stage 1 + YaRN weights-only warm-start stage 2, why the
optimizer state must be dropped, the transformers-5.x dual-rope-schema
checkpoint pitfall, and the bucketed-accept-length validation protocol.
@Boreas618
Boreas618 force-pushed the agent/dspark-recipe-docs branch from 02087ad to 1e21895 Compare August 1, 2026 17:32
@Boreas618 Boreas618 closed this Aug 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant