Skip to content

docs(model-providers): replace hand-maintained Cohere model lists and fix related drift - #516

Open
g-despot wants to merge 1 commit into
mainfrom
docs/cohere-openai-model-lists
Open

docs(model-providers): replace hand-maintained Cohere model lists and fix related drift#516
g-despot wants to merge 1 commit into
mainfrom
docs/cohere-openai-model-lists

Conversation

@g-despot

Copy link
Copy Markdown
Contributor

What's being changed:

Core stopped validating model names for the Cohere modules in v1.33.0 (backported to v1.31.17 and v1.32.10), so the hand-maintained lists on those pages are guaranteed to rot. Each is replaced with the no-validation statement, the server default, and a link to Cohere's own model documentation.

Four corrections found alongside:

  • openai/embeddings.md said you can use any OpenAI embedding model. That is false — text2vec-openai still validates against an allowlist (ent/class_settings.go:185-192). The page also never stated its server default (text-embedding-3-small), and its (default) markers refer to dimensions, not model choice.
  • openai/generative.md's list is the token-limit table, not an availability list. Kept and demoted into a <details>, with a lead-in saying what it does: it caps maxTokens for those models.
  • return_likelihoods removed from four snippets. The Python client accepts and silently discards it, and core has no reader on any path — so the snippets showed a live-looking option that does nothing.
  • Six Python/TypeScript snippet pairs disagreed on the same example (dimensions, the multimodal model, and one model left active in TypeScript while commented in Python).

Type of change:

  • Documentation content updates (non-breaking change to fix/update documentation )

How has this been tested?

Not built locally. Marker names in the four _includes files are byte-identical to main (so no page lost a snippet), <details>/<Tabs>/<TabItem> pairing was re-checked on all six pages, both _includes Python files compile, and every #available-models / #vectorizer-parameters / #generative-parameters anchor still resolves. Relying on the deploy preview for the site build.

… fix related drift

Core stopped validating model names for the Cohere modules in v1.33.0
(backported to v1.31.17 and v1.32.10), so any model string is forwarded
verbatim and the static lists on those pages are guaranteed to rot.
Replace each list with the no-validation statement, the server default,
and a link to Cohere's own model documentation.

Also corrected while in these pages:

- openai/embeddings.md said you can use any OpenAI embedding model, but
  text2vec-openai still validates against an allowlist. The page also
  never stated its server default (text-embedding-3-small), and its
  "(default)" markers refer to dimensions, not model choice.
- openai/generative.md's list is Weaviate's token-limit table, not an
  availability list. Kept and demoted, with a lead-in saying what it
  does: it caps maxTokens for those models.
- return_likelihoods dropped from four snippets. The Python client
  accepts and silently discards it, and core has no reader on any path.
- Six Python/TypeScript snippet pairs showed different values for the
  same example (dimensions, the multimodal model, and one model left
  active in TypeScript while commented in Python).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017AryMRLot3XAaz2s44eNG6

@orca-security-eu orca-security-eu Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Orca Security Scan Summary

Status Check Issues by priority
Passed Passed Infrastructure as Code high 0   medium 0   low 0   info 0 View in Orca
Passed Passed SAST high 0   medium 0   low 0   info 0 View in Orca
Passed Passed Secrets high 0   medium 0   low 0   info 0 View in Orca
Passed Passed Vulnerabilities high 0   medium 0   low 0   info 0 View in Orca

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