Skip to content

docs: rewrite Model Providers page and finish 1.15.0 terminology cleanup#821

Merged
RiskeyL merged 4 commits into
release/1.15.0from
docs/model-providers-rewrite
Jun 23, 2026
Merged

docs: rewrite Model Providers page and finish 1.15.0 terminology cleanup#821
RiskeyL merged 4 commits into
release/1.15.0from
docs/model-providers-rewrite

Conversation

@RiskeyL

@RiskeyL RiskeyL commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Rewrite the Model Providers page (en/zh/ja). Trimmed to the tasks the UI doesn't make self-evident, with the navigation and button labels (Integrations > Model Provider, Setup/Configure, Add Model, Manage Credentials, Default Models) verified against the current 1.15.0 i18n. Adds the install-from-Marketplace step and a Default Models section, explains when you add a model manually versus when models are ready to use, and drops the stale Supported Providers list, frozen config examples, UI-restating permission list, and shallow troubleshooting.
  • Home page: the Marketplace card now says "integrations" instead of "plugins" to match the product. The Develop Plugins card stays, since the develop-plugin tree keeps "plugin" for developers.
  • TRIGGER_URL env var: renamed "plugin trigger" to "integration trigger" in the description (en/zh/ja), the one spot the navigation pass didn't reach.
  • Formatting guide: relaxed the em-dash rule from a hard one-per-paragraph cap to a judgment-based standard (use sparingly, don't stack or pile up, but not banned).

Chinese and Japanese are synced across all four changes.

RiskeyL and others added 4 commits June 23, 2026 13:19
Trim the page to the tasks that aren't self-evident in the UI and
align it with the current product:

- Lead each section from the user's task (add a provider, add a custom
  model, manage credentials, set default models)
- Correct the navigation and button labels (Integrations > Model
  Provider, Setup/Configure, Add Model, Manage Credentials, Default
  Models) against the current i18n
- Add the install-from-Marketplace step and the Default Models section
- Explain when you add a model manually vs. when models are ready to use
- Remove the stale Supported Providers list, frozen configuration
  examples, UI-restating permission list, and shallow troubleshooting
- Sync zh and ja

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Update the Marketplace card to match the 1.15.0 product terminology.
The Develop Plugins card stays, since the develop-plugin tree keeps
the "plugin" term for developers.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Align the TRIGGER_URL environment variable description with the
Integration Trigger rename shipped in 1.15.0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change the rule from a hard one-per-paragraph cap to a judgment-based
standard: em dashes can aid readability and aren't banned, but avoid
stacking them in a sentence or piling them up across a page.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 23, 2026 05:23
@dosubot dosubot Bot added size:XL This PR changes 500-999 lines, ignoring generated files. documentation Improvements or additions to documentation labels Jun 23, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR updates Dify documentation to match 1.15.0 UI terminology and guidance, centered on a rewritten “Model Providers” page and a terminology cleanup from “plugin” to “integration” where applicable.

Changes:

  • Rewrites the Model Providers page (en/zh/ja) to focus on Marketplace installation, adding providers, adding custom models, managing credentials, and setting default models.
  • Updates the home page Marketplace card copy (en/zh/ja) from “plugins” to “integrations”.
  • Renames “plugin trigger” to “integration trigger” in TRIGGER_URL environment variable documentation (en/zh/ja) and relaxes the em-dash guidance in the formatting guide.

Reviewed changes

Copilot reviewed 10 out of 11 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
en/self-host/use-dify/workspace/model-providers.mdx Rewrites the page structure and instructions; adds Marketplace + Default Models guidance.
zh/self-host/use-dify/workspace/model-providers.mdx Chinese version of the rewritten Model Providers page.
ja/self-host/use-dify/workspace/model-providers.mdx Japanese version of the rewritten Model Providers page.
en/self-host/deploy/configuration/environments.mdx Updates TRIGGER_URL description from “plugin trigger” to “integration trigger”.
zh/self-host/deploy/configuration/environments.mdx Chinese TRIGGER_URL terminology update.
ja/self-host/deploy/configuration/environments.mdx Japanese TRIGGER_URL terminology update.
en/home.mdx Updates Marketplace card copy to say “integrations”.
zh/home.mdx Chinese Marketplace card terminology update.
ja/home.mdx Japanese Marketplace card terminology update.
writing-guides/formatting-guide.md Updates em-dash guidance to a judgment-based standard and adjusts the checklist.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread en/self-host/use-dify/workspace/model-providers.mdx
Comment thread en/self-host/use-dify/workspace/model-providers.mdx
Comment thread zh/self-host/use-dify/workspace/model-providers.mdx
Comment thread zh/self-host/use-dify/workspace/model-providers.mdx
Comment thread ja/self-host/use-dify/workspace/model-providers.mdx
@RiskeyL RiskeyL merged commit 8e46ecc into release/1.15.0 Jun 23, 2026
5 checks passed
@RiskeyL RiskeyL deleted the docs/model-providers-rewrite branch June 23, 2026 05:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size:XL This PR changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants