Skip to content

docs: recommend Opus 4.8 over Opus 4.7#1262

Open
shashank-factory wants to merge 1 commit into
mainfrom
shashank/docs-opus-4-8
Open

docs: recommend Opus 4.8 over Opus 4.7#1262
shashank-factory wants to merge 1 commit into
mainfrom
shashank/docs-opus-4-8

Conversation

@shashank-factory

Copy link
Copy Markdown
Contributor

What

Updates model recommendations to lead with the new Opus 4.8 flagship instead of Opus 4.7, across English docs and their Japanese mirrors:

  • cli/user-guides/choosing-your-model.mdx — §2 "Match the model to the job" rows, the Tip, and §4 reasoning-effort listing (adds an Opus 4.8 line + includes it in the "Max is available on…" sentence)
  • cli/configuration/mixed-models.mdx — Spec-mode model recommendation
  • guides/power-user/prompt-crafting.mdx — "Complex architecture" row
  • guides/power-user/token-efficiency.mdx — "Architecture planning" row
  • jp/ mirrors of all four files

Opus 4.7 is retained as a fallback/alternative everywhere. The stale "1× promotional multiplier through April 30" wording is dropped, since Opus 4.8 is a flat 2× with no promo.

Deliberately NOT changed

These are catalog/data/historical references, not recommendations:

  • models.mdx (model catalog table)
  • snippets/leaderboards/review-benchmark.mdx (numbers measured for 4.7)
  • changelog/1-9.mdx (historical)
  • enterprise/eu-deployment.mdxOpus 4.8 is not yet available in the EU, so changing this would be inaccurate
  • §1 stack-rank rows in choosing-your-model (already list both 4.8 and 4.7)

Companion PR

CLI splash screen: Factory-AI/factory-mono#15401

Testing

  • Reviewed full diff; markdown tables and MDX structure intact
  • mint broken-links surfaces only a pre-existing parse error in jp/web/machine-connection/cloud-templates/index.mdx (unrelated, not touched here)

Update model recommendations to lead with the new Opus 4.8 flagship in
the choosing-your-model guide, mixed-models config, and the power-user
prompt-crafting / token-efficiency guides (English + Japanese mirrors).
Opus 4.7 stays listed as a fallback/alternative. Catalog, benchmark,
changelog, and EU-availability references are left unchanged (Opus 4.8
is not yet available in the EU).
@factory-droid

factory-droid Bot commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Droid encountered an error —— View job


Security Review

Droid is reviewing code and running a security check…

@mintlify

mintlify Bot commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
factory 🟢 Ready View Preview Jun 26, 2026, 7:17 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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