Skip to content

docs: clarify model config IDs#30262

Open
849261680 wants to merge 1 commit into
anomalyco:devfrom
849261680:codex-docs-model-small-model-provider-syntax
Open

docs: clarify model config IDs#30262
849261680 wants to merge 1 commit into
anomalyco:devfrom
849261680:codex-docs-model-small-model-provider-syntax

Conversation

@849261680
Copy link
Copy Markdown

@849261680 849261680 commented Jun 1, 2026

Issue for this PR

Closes #29639

Type of change

  • Bug fix
  • New feature
  • Refactor / code improvement
  • Documentation

What does this PR do?

Clarifies the model and small_model config values in packages/web/src/content/docs/config.mdx. The docs now state that both values use provider_id/model_id, point users to opencode models and Models.dev for built-in provider/model IDs, explain how custom provider IDs map to the config keys, and note that small_model can use a different provider from the main model.

This addresses the confusion in #29639 about which part of provider/model is the provider and confirms the cross-provider small_model behavior.

How did you verify your code works?

  • npm exec --yes prettier@3.6.2 -- --check packages/web/src/content/docs/config.mdx
  • GitHub PR checks pass

I could not run the local Astro check because bun is not installed in this environment.

Screenshots / recordings

N/A, documentation-only change.

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

@github-actions github-actions Bot added needs:compliance This means the issue will auto-close after 2 hours. and removed needs:compliance This means the issue will auto-close after 2 hours. labels Jun 1, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 1, 2026

Thanks for updating your PR! It now meets our contributing guidelines. 👍

@849261680 849261680 marked this pull request as ready for review June 1, 2026 19:52
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.

[DOCS]: Clarify model/small_model syntax is {provider}/{model}

1 participant