Skip to content

fix: converge zh/ja webapp guides with current en - #880

Merged
RiskeyL merged 1 commit into
mainfrom
47/dc-18-translation-tree-drift-in-the-webapp-guides-zhja-vs-en
Jul 17, 2026
Merged

RiskeyL merged 1 commit into
mainfrom
47/dc-18-translation-tree-drift-in-the-webapp-guides-zhja-vs-en

Conversation

@RiskeyL

@RiskeyL RiskeyL commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Fixes the translation-tree drift found in the DC-17 corruption review (tracked as DC-18): zh/ja copies of the publish/webapp guides had diverged from the en source in ways invisible to the sync radars.

  • Retranslate zh embedding-in-websites from the current en source (cloud + self-host): frontmatter, intro, embedding-methods section with the missing <Info>, chat-bubble and iframe intros, accordion set, and the troubleshooting block whose <Warning> no longer matched en.
  • Drop the stale best-practices section from zh/ja workflow-webapp (4 copies). en removed it deliberately in d68fded2 (2025-09-19); the translations never followed.
  • Restructure the three em-dash (——) sentences in cloud zh web-app-access per tools/translate/formatting-zh.md.

Format + terminology checks (whole files): 0 violations introduced, 23 pre-existing fixed. The EE-side copies of these fixes are deferred until the EE docs repo write freeze lifts and stay tracked on DC-18.

- Retranslate zh embedding-in-websites from the current en source (cloud + self-host)
- Drop the stale best-practices section from zh/ja workflow-webapp (en removed it in d68fded)
- Restructure the three em-dash sentences in cloud zh web-app-access per formatting-zh

Part of DC-18; the EE-side copies follow after the DC-30 write freeze lifts.
Copilot AI review requested due to automatic review settings July 17, 2026 07:20
@dosubot dosubot Bot added size:L This PR changes 100-499 lines, ignoring generated files. documentation Improvements or additions to documentation labels Jul 17, 2026
@mintlify

mintlify Bot commented Jul 17, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
dify-core-product 🟢 Ready View Preview Jul 17, 2026, 7:22 AM

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

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 reduces translation drift by aligning the zh/ja Web App publishing guides with the current English source, removing outdated sections and updating translated structure/content where the English docs have evolved.

Changes:

  • Retranslates zh embedding-in-websites (cloud + self-host) to match current en structure (frontmatter, <Info>, embedding method descriptions, accordion set, and troubleshooting block).
  • Removes the stale “best practices” section from workflow-webapp in zh/ja (cloud + self-host) to match the en removal.
  • Adjusts zh cloud web-app-access punctuation/structure to conform with current translation formatting expectations.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
zh/self-host/use-dify/publish/webapp/workflow-webapp.mdx Removes deprecated “最佳实践” section to match en.
zh/self-host/use-dify/publish/webapp/embedding-in-websites.mdx Re-syncs the embedding guide content/structure with en, including frontmatter and troubleshooting.
zh/cloud/use-dify/publish/webapp/workflow-webapp.mdx Removes deprecated “最佳实践” section to match en.
zh/cloud/use-dify/publish/webapp/web-app-access.mdx Refactors sentences to remove em-dash patterns and improve consistency with en/formatting guidance.
zh/cloud/use-dify/publish/webapp/embedding-in-websites.mdx Re-syncs the embedding guide content/structure with en, including frontmatter and troubleshooting.
ja/self-host/use-dify/publish/webapp/workflow-webapp.mdx Removes deprecated “ベストプラクティス” section to match en.
ja/cloud/use-dify/publish/webapp/workflow-webapp.mdx Removes deprecated “ベストプラクティス” section to match en.

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

@RiskeyL
RiskeyL merged commit 9ae0d9d into main Jul 17, 2026
5 checks passed
@RiskeyL
RiskeyL deleted the 47/dc-18-translation-tree-drift-in-the-webapp-guides-zhja-vs-en branch July 17, 2026 11:42
@RiskeyL

RiskeyL commented Jul 17, 2026

Copy link
Copy Markdown
Contributor Author

💚 All backports created successfully

Status Branch Result
✅ release/1.15.0
✅ release/1.16.0-rc1

Questions ?

Please refer to the Backport tool documentation and see the Github Action logs for details

RiskeyL added a commit that referenced this pull request Jul 17, 2026
- Retranslate zh embedding-in-websites from the current en source (cloud + self-host)
- Drop the stale best-practices section from zh/ja workflow-webapp (en removed it in d68fded)
- Restructure the three em-dash sentences in cloud zh web-app-access per formatting-zh

Part of DC-18; the EE-side copies follow after the DC-30 write freeze lifts.

(cherry picked from commit 9ae0d9d)
RiskeyL added a commit that referenced this pull request Jul 17, 2026
- Retranslate zh embedding-in-websites from the current en source (cloud + self-host)
- Drop the stale best-practices section from zh/ja workflow-webapp (en removed it in d68fded)
- Restructure the three em-dash sentences in cloud zh web-app-access per formatting-zh

Part of DC-18; the EE-side copies follow after the DC-30 write freeze lifts.

(cherry picked from commit 9ae0d9d)

This branch was successfully deployed

1 active deployment
staging — eb4f6c3e Deployed Jul 17, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport-to-release/1.15.0 backport-to-release/1.16.0-rc1 documentation Improvements or additions to documentation size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants