Skip to content

Remove experimental labels from samplingMode in spec and explainer - #226

Merged
michaelwasserman merged 1 commit into
webmachinelearning:mainfrom
isaacahouma:sampling-mode-remove-experimental
Oct 27, 2026
Merged

michaelwasserman merged 1 commit into
webmachinelearning:mainfrom
isaacahouma:sampling-mode-remove-experimental

Conversation

@isaacahouma

@isaacahouma isaacahouma commented Oct 21, 2026 •

Copy link
Copy Markdown
Collaborator

Removes the // **EXPERIMENTAL**: Only available in experimental contexts. WebIDL comments above LanguageModel.samplingMode and LanguageModelCreateCoreOptions.samplingMode in index.bs, renames ## Experiments and Updates in README.md to ## Updates and Deprecations, updates the Sampling Parameters overview to note that the legacy raw sampling parameter features are deprecated and only functional within web extension contexts while developers can use samplingMode presets instead, and cleans up a stale temperature comment in the availability() example.


Preview | Diff

@isaacahouma
isaacahouma force-pushed the sampling-mode-remove-experimental branch 3 times, most recently from f6f9e6b to a77c2fd Compare October 21, 2026 16:59
Removes the // **EXPERIMENTAL** WebIDL comments above
LanguageModel.samplingMode and LanguageModelCreateCoreOptions.samplingMode
in index.bs, renames the top README.md section to Updates and Deprecations,
updates the Sampling Parameters overview to note that the legacy raw
sampling parameter features are deprecated and only functional within web
extension contexts while developers can use samplingMode presets instead,
and removes a stale temperature reference in an availability() example.
@isaacahouma
isaacahouma force-pushed the sampling-mode-remove-experimental branch from a77c2fd to 5a19a71 Compare October 21, 2026 17:05
@isaacahouma
isaacahouma marked this pull request as ready for review October 21, 2026 17:32

@michaelwasserman michaelwasserman left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm with comment nits for optional followup

Comment thread index.bs
unrestricted double temperature;

// **EXPERIMENTAL**: Only available in experimental contexts.
LanguageModelSamplingMode samplingMode;

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consider add a brief comment like "The requested sampling mode for this session."

Comment thread index.bs
readonly attribute float temperature;

// **EXPERIMENTAL**: Only available in experimental contexts.
readonly attribute LanguageModelSamplingMode? samplingMode;

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consider adding a brief comment like "The resolved sampling mode for the session."
Maybe we can comment that it might be null in extension contexts, while those still support legacy params?

@michaelwasserman
michaelwasserman merged commit c2b9266 into webmachinelearning:main Oct 27, 2026
2 checks passed
github-actions Bot added a commit that referenced this pull request Oct 27, 2026
)

SHA: c2b9266
Reason: push, by michaelwasserman

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
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.

2 participants