docs: rewrite Model Providers page and finish 1.15.0 terminology cleanup#821
Merged
Conversation
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>
Contributor
There was a problem hiding this comment.
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Chinese and Japanese are synced across all four changes.