Skip to content

chore: bulk formatting cleanup and post-writing format-check skills#751

Merged
RiskeyL merged 9 commits into
mainfrom
chore/bulk-cleanup
Apr 17, 2026
Merged

chore: bulk formatting cleanup and post-writing format-check skills#751
RiskeyL merged 9 commits into
mainfrom
chore/bulk-cleanup

Conversation

@RiskeyL
Copy link
Copy Markdown
Contributor

@RiskeyL RiskeyL commented Apr 17, 2026

Summary

A round of bulk formatting cleanup across en/zh/ja documentation, plus two new skills that enforce the same rules going forward.

Formatting cleanup (7 commits)

  • style: move trailing colons outside bold asterisks — relocates colons from inside bold markers (**Start:**) to after them (**Start**:) across en, zh, and ja. 433 replacements in 100 files. Colons inside bold can break rendering when adjacent to other inline syntax.
  • style: normalize punctuation widths across en, zh, ja — full-width punctuation (，。：？（）) in Chinese and Japanese prose when adjacent to CJK, half-width in English prose. Japanese uses 、 for commas. 114 line changes across 36 files.
  • docs: document frontmatter quoting rule — replaces the vague "quote values that contain special characters" guidance with a concrete rule: bare by default, double-quote only when the value contains a colon followed by a space.
  • style: remove triple-asterisk horizontal rule dividers — 71 divider lines removed across 38 files. The versions/ folder and the import-text-data readme are excluded because the dividers serve a layout purpose there.
  • style: convert -ing headings to base form across en docs — 111 headings and frontmatter titles rewritten to use the imperative form per the formatting guide. Noun-phrase gerunds and conventional section names (Troubleshooting, Getting Started, Monitoring Data List, etc.) are preserved.

New post-writing skills

  • feat: add English and CJK format-check skills — two new skills under .claude/skills/:
    • dify-docs-format-check-en enforces every rule in writing-guides/formatting-guide.md via a Python linter plus a SKILL.md judgment-call section.
    • dify-docs-format-check-cjk covers general rules plus Chinese-specific rules from tools/translate/formatting-zh.md and Japanese-specific rules from tools/translate/formatting-ja.md. Auto-selects the rule set based on the file path.
  • docs: centralize post-writing verification in writing-guides index — moves the canonical post-writing checklist into writing-guides/index.md so it lives in one place, adds the two new skills to that list, and shortens the Post-Writing section in each writing skill to a one-line pointer.

RiskeyL and others added 4 commits April 17, 2026 17:02
@RiskeyL @claude
style: move trailing colons outside bold asterisks
6934b74 
Relocates colons from inside bold markers (`**Start:**`) to after them (`**Start**:`) across en, zh, and ja. Colons that sit inside bold markers can break rendering when adjacent to other inline syntax, so keeping them outside produces more reliable output. Preserves colon width (half-width and full-width) and leaves code fences and inline code spans untouched.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@RiskeyL @claude
style: normalize punctuation widths across en, zh, ja
b9da4c5 
Corrects punctuation width to match the surrounding language: full-width forms (，。：？（）) in Chinese and Japanese prose when adjacent to CJK characters, half-width forms in English prose. Japanese uses 、 for commas. One Latin-heavy list in ja/use-dify/workspace/model-providers.mdx was left untouched because converting only its trailing comma would break visual consistency.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@RiskeyL @claude
docs: document frontmatter quoting rule
a514992 
Replaces the vague "quote values that contain special characters" guidance with a concrete rule: leave values unquoted by default, wrap in double quotes only when the value contains a colon followed by a space. This is the one case where YAML would otherwise misparse the value. Example frontmatter block updated to show bare values.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@RiskeyL @claude
style: remove triple-asterisk horizontal rule dividers
aad1688 
Deletes standalone *** divider lines across en, zh, and ja docs. Our pages rely on headings for structure, so horizontal rules add visual noise without carrying meaning. Excludes the versions/ folder and use-dify/knowledge/create-knowledge/import-text-data/readme.mdx where the dividers serve a layout purpose. Code fences are left untouched.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 17, 2026 13:33
@dosubot dosubot Bot added the size:XXL This PR changes 1000+ lines, ignoring generated files. label Apr 17, 2026
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented Apr 17, 2026 •
edited
Loading

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

Project Status Preview Updated (UTC)
dify-core-product 🟢 Ready View Preview Apr 17, 2026, 1:36 PM

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

@dosubot dosubot Bot added the documentation Improvements or additions to documentation label Apr 17, 2026
Copilot AI reviewed Apr 17, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

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 standardizes documentation formatting across English, Chinese, and Japanese content (e.g., moving trailing colons outside bold markers and normalizing punctuation), and updates the writing guides + Claude skills so the same formatting rules can be enforced after writing.

Changes:

  • Bulk doc formatting cleanup across en/, zh/, and ja/ (bold/colon patterns, punctuation normalization, divider removal, heading normalization).
  • Adds a centralized “Post-Writing Verification” checklist to writing-guides/index.md.
  • Clarifies the YAML frontmatter quoting rule in writing-guides/formatting-guide.md and updates existing writing skills to point to the centralized checklist.

Reviewed changes

Copilot reviewed 177 out of 179 changed files in this pull request and generated 12 comments.

Show a summary per file
File Description
zh/use-dify/workspace/team-members-management.mdx Formatting normalization (bold+colon), plus touched member/access label lines.
zh/use-dify/workspace/subscription-management.mdx Formatting normalization for label lines.
zh/use-dify/workspace/plugins.mdx Formatting normalization for label lines.
zh/use-dify/workspace/personal-account-management.mdx Formatting normalization for label lines.
zh/use-dify/workspace/app-management.mdx Formatting normalization for section labels.
zh/use-dify/tutorials/workflow-101/lesson-10.mdx Formatting normalization for a bold+colon line.
zh/use-dify/tutorials/workflow-101/lesson-06.mdx Punctuation-width normalization in type labels.
zh/use-dify/tutorials/workflow-101/lesson-04.mdx Punctuation-width normalization (parentheses).
zh/use-dify/tutorials/workflow-101/lesson-02.mdx Punctuation-width normalization (parentheses).
zh/use-dify/tutorials/workflow-101/lesson-01.mdx Punctuation-width normalization (colon).
zh/use-dify/tutorials/twitter-chatflow.mdx Punctuation normalization (comma spacing).
zh/use-dify/tutorials/build-ai-image-generation-app.mdx Punctuation normalization (comma/colon).
zh/use-dify/publish/webapp/workflow-webapp.mdx Formatting normalization for labels/headings.
zh/use-dify/publish/webapp/web-app-settings.mdx Formatting normalization for labels within tabs and sections.
zh/use-dify/publish/webapp/embedding-in-websites.mdx Formatting normalization for labels.
zh/use-dify/publish/webapp/chatflow-webapp.mdx Formatting normalization for labels.
zh/use-dify/publish/developing-with-apis.mdx Formatting normalization for labels/list items.
zh/use-dify/nodes/question-classifier.mdx Formatting normalization for labels.
zh/use-dify/nodes/loop.mdx Formatting normalization for labels.
zh/use-dify/nodes/list-operator.mdx Formatting normalization for a label.
zh/use-dify/nodes/iteration.mdx Formatting normalization for labels.
zh/use-dify/monitor/logs.mdx Formatting normalization for labels/list items.
zh/use-dify/monitor/integrations/integrate-weave.mdx Divider removal + punctuation normalization.
zh/use-dify/monitor/integrations/integrate-phoenix.mdx Divider removal.
zh/use-dify/monitor/integrations/integrate-langsmith.mdx Divider removal.
zh/use-dify/monitor/integrations/integrate-langfuse.mdx Divider removal + formatting normalization in lists.
zh/use-dify/monitor/integrations/integrate-arize.mdx Divider removal.
zh/use-dify/monitor/annotation-reply.mdx Formatting normalization for labels.
zh/use-dify/monitor/analysis.mdx Formatting normalization for metric labels.
zh/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx Punctuation-width normalization (parentheses).
zh/use-dify/knowledge/integrate-knowledge-within-application.mdx Divider removal.
zh/self-host/troubleshooting/integrations.mdx Formatting normalization for OS labels.
zh/self-host/quick-start/faqs.mdx Formatting normalization for a label.
zh/develop-plugin/publishing/standards/privacy-protection-guidelines.mdx Formatting normalization for label lines.
zh/develop-plugin/publishing/marketplace-listing/release-to-dify-marketplace.mdx Divider removal.
zh/develop-plugin/features-and-specs/plugin-types/model-schema.mdx Divider removal.
zh/develop-plugin/features-and-specs/advanced-development/reverse-invocation-app.mdx Formatting normalization for a label.
zh/develop-plugin/features-and-specs/advanced-development/customizable-model.mdx Divider removal + formatting normalization for section labels.
zh/develop-plugin/dev-guides-and-walkthroughs/tool-plugin.mdx Formatting normalization for section labels.
zh/develop-plugin/dev-guides-and-walkthroughs/endpoint.mdx Punctuation-width normalization in a list item.
zh/develop-plugin/dev-guides-and-walkthroughs/develop-a-slack-bot-plugin.mdx Formatting normalization for section labels.
zh/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider.mdx Formatting normalization for “示例” labels + divider removal.
zh/develop-plugin/dev-guides-and-walkthroughs/cheatsheet.mdx Formatting normalization for platform labels.
writing-guides/index.md Adds centralized Post-Writing Verification checklist/table.
writing-guides/formatting-guide.md Updates frontmatter example + clarifies quoting rule.
ja/use-dify/workspace/team-members-management.mdx Formatting normalization for label lines.
ja/use-dify/workspace/subscription-management.mdx Formatting normalization for label lines.
ja/use-dify/workspace/plugins.mdx Formatting normalization for label lines.
ja/use-dify/workspace/personal-account-management.mdx Formatting normalization for label lines.
ja/use-dify/workspace/model-providers.mdx Formatting normalization for labels and troubleshooting items.
ja/use-dify/workspace/app-management.mdx Formatting normalization for labels/headings.
ja/use-dify/workspace/api-extension/moderation-api-extension.mdx Punctuation-width normalization (colon).
ja/use-dify/workspace/api-extension/cloudflare-worker.mdx Punctuation-width normalization (colon).
ja/use-dify/tutorials/workflow-101/lesson-10.mdx Formatting normalization for a bold+colon line.
ja/use-dify/tutorials/workflow-101/lesson-05.mdx Formatting normalization in step text.
ja/use-dify/tutorials/workflow-101/lesson-03.mdx Formatting normalization in step text.
ja/use-dify/publish/webapp/workflow-webapp.mdx Formatting normalization for labels/headings.
ja/use-dify/publish/webapp/web-app-settings.mdx Formatting normalization for labels within tabs and sections.
ja/use-dify/publish/webapp/embedding-in-websites.mdx Formatting normalization for labels.
ja/use-dify/publish/webapp/chatflow-webapp.mdx Formatting normalization for labels.
ja/use-dify/publish/developing-with-apis.mdx Formatting normalization for list labels.
ja/use-dify/nodes/tools.mdx Punctuation-width normalization (colon).
ja/use-dify/nodes/question-classifier.mdx Formatting normalization for labels.
ja/use-dify/nodes/loop.mdx Formatting normalization for labels.
ja/use-dify/nodes/list-operator.mdx Formatting normalization for a label.
ja/use-dify/nodes/iteration.mdx Formatting normalization for labels.
ja/use-dify/monitor/logs.mdx Formatting normalization for labels/list items.
ja/use-dify/monitor/integrations/integrate-weave.mdx Divider removal.
ja/use-dify/monitor/integrations/integrate-phoenix.mdx Divider removal.
ja/use-dify/monitor/integrations/integrate-langsmith.mdx Divider removal.
ja/use-dify/monitor/integrations/integrate-arize.mdx Divider removal.
ja/use-dify/monitor/integrations/integrate-aliyun.mdx Divider removal + punctuation-width normalization in note text.
ja/use-dify/monitor/annotation-reply.mdx Formatting normalization for labels.
ja/use-dify/monitor/analysis.mdx Punctuation-width normalization + metric label formatting.
ja/use-dify/knowledge/knowledge-request-rate-limit.mdx Punctuation-width normalization in heading.
ja/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx Formatting normalization for warning labels.
ja/use-dify/knowledge/integrate-knowledge-within-application.mdx Divider removal.
ja/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx Formatting normalization for labels + divider removal.
ja/use-dify/knowledge/create-knowledge/import-text-data/sync-from-website.mdx Divider removal.
ja/use-dify/knowledge/connect-external-knowledge-base.mdx Formatting normalization for a label line.
ja/use-dify/build/workflow-chatflow.mdx Punctuation-width normalization (colon).
ja/use-dify/build/version-control.mdx Punctuation-width normalization (colons).
ja/use-dify/build/text-generator.mdx Punctuation-width normalization (colons) + formatting normalization.
ja/use-dify/build/chatbot.mdx Punctuation-width normalization (colons) + formatting normalization.
ja/use-dify/build/agent.mdx Punctuation-width normalization (colons) + formatting normalization.
ja/use-dify/build/additional-features.mdx Punctuation-width normalization in env var default labels.
ja/self-host/troubleshooting/integrations.mdx Formatting normalization for OS labels.
ja/self-host/quick-start/faqs.mdx Formatting normalization for a label line.
ja/self-host/platform-guides/bt-panel.mdx Punctuation-width normalization (colons) in list labels.
ja/self-host/advanced-deployments/local-source-code.mdx Divider removal.
ja/develop-plugin/publishing/standards/privacy-protection-guidelines.mdx Formatting normalization for label lines.
ja/develop-plugin/publishing/standards/contributor-covenant-code-of-conduct.mdx Punctuation-width normalization (colons) in list labels.
ja/develop-plugin/publishing/marketplace-listing/release-to-dify-marketplace.mdx Divider removal.
ja/develop-plugin/publishing/marketplace-listing/release-overview.mdx Punctuation-width normalization (colons).
ja/develop-plugin/publishing/marketplace-listing/plugin-auto-publish-pr.mdx Punctuation-width normalization (colons) in labels/lists.
ja/develop-plugin/features-and-specs/plugin-types/multilingual-readme.mdx Punctuation-width normalization (parentheses).
ja/develop-plugin/features-and-specs/plugin-types/model-schema.mdx Divider removal.
ja/develop-plugin/features-and-specs/advanced-development/reverse-invocation-app.mdx Formatting normalization for a label.
ja/develop-plugin/features-and-specs/advanced-development/customizable-model.mdx Divider removal + formatting normalization for section labels.
ja/develop-plugin/dev-guides-and-walkthroughs/tool-plugin.mdx Punctuation-width normalization (colon) in image alt + section labels.
ja/develop-plugin/dev-guides-and-walkthroughs/endpoint.mdx Punctuation-width normalization + label punctuation.
ja/develop-plugin/dev-guides-and-walkthroughs/develop-a-slack-bot-plugin.mdx Formatting normalization for section labels.
ja/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider.mdx Divider removal + formatting normalization for “例” labels.
ja/develop-plugin/dev-guides-and-walkthroughs/cheatsheet.mdx Punctuation-width normalization (colons) and label formatting.
en/use-dify/workspace/team-members-management.mdx Formatting normalization for lists/labels + heading base-form.
en/use-dify/workspace/subscription-management.mdx Heading base-form + label formatting normalization.
en/use-dify/workspace/plugins.mdx Heading base-form + label formatting normalization.
en/use-dify/workspace/personal-account-management.mdx Label formatting normalization.
en/use-dify/workspace/model-providers.mdx Label formatting normalization.
en/use-dify/workspace/app-management.mdx Heading base-form + label formatting normalization.
en/use-dify/tutorials/workflow-101/lesson-10.mdx Formatting normalization for a bold+colon line.
en/use-dify/tutorials/workflow-101/lesson-05.mdx Formatting normalization in step text.
en/use-dify/tutorials/workflow-101/lesson-03.mdx Formatting normalization in step text.
en/use-dify/tutorials/customer-service-bot.mdx Heading base-form.
en/use-dify/tutorials/build-ai-image-generation-app.mdx Heading base-form + fixes Stability heading wording.
en/use-dify/tutorials/article-reader.mdx Heading base-form.
en/use-dify/publish/webapp/workflow-webapp.mdx Heading base-form + label formatting normalization.
en/use-dify/publish/webapp/web-app-settings.mdx Label formatting normalization.
en/use-dify/publish/webapp/web-app-access.mdx Heading base-form.
en/use-dify/publish/webapp/embedding-in-websites.mdx Title/heading base-form + label formatting normalization.
en/use-dify/publish/webapp/chatflow-webapp.mdx Label formatting normalization.
en/use-dify/publish/publish-mcp.mdx Heading base-form.
en/use-dify/publish/developing-with-apis.mdx Label formatting normalization.
en/use-dify/nodes/question-classifier.mdx Label formatting normalization.
en/use-dify/nodes/loop.mdx Label formatting normalization.
en/use-dify/nodes/list-operator.mdx Label formatting normalization.
en/use-dify/nodes/iteration.mdx Label formatting normalization.
en/use-dify/monitor/logs.mdx Heading base-form + label formatting normalization.
en/use-dify/monitor/integrations/integrate-weave.mdx Divider removal + heading base-form.
en/use-dify/monitor/integrations/integrate-phoenix.mdx Divider removal + heading base-form.
en/use-dify/monitor/integrations/integrate-opik.mdx Heading base-form.
en/use-dify/monitor/integrations/integrate-langsmith.mdx Divider removal + heading base-form.
en/use-dify/monitor/integrations/integrate-langfuse.mdx Divider removal + heading base-form + punctuation fix.
en/use-dify/monitor/integrations/integrate-arize.mdx Divider removal + heading base-form.
en/use-dify/monitor/integrations/integrate-aliyun.mdx Divider removal + heading base-form.
en/use-dify/monitor/annotation-reply.mdx Heading base-form + label formatting normalization.
en/use-dify/monitor/analysis.mdx Label formatting normalization.
en/use-dify/knowledge/metadata.mdx Label formatting normalization + punctuation fix.
en/use-dify/knowledge/knowledge-pipeline/authorize-data-source.mdx Heading base-form.
en/use-dify/knowledge/integrate-knowledge-within-application.mdx Divider removal + heading base-form + list label formatting.
en/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx Divider removal + label formatting normalization.
en/use-dify/knowledge/create-knowledge/import-text-data/sync-from-website.mdx Divider removal + heading base-form.
en/use-dify/knowledge/create-knowledge/import-text-data/sync-from-notion.mdx Heading base-form.
en/use-dify/debug/variable-inspect.mdx Heading base-form.
en/use-dify/debug/step-run.mdx Heading base-form.
en/use-dify/build/version-control.mdx Heading base-form.
en/use-dify/build/predefined-error-handling-logic.mdx Title base-form.
en/use-dify/build/mcp.mdx Title/headings base-form.
en/self-host/troubleshooting/integrations.mdx Formatting normalization for OS labels.
en/self-host/quick-start/faqs.mdx Formatting normalization for a label line.
en/self-host/advanced-deployments/local-source-code.mdx Punctuation-width normalization (Expected output).
en/develop-plugin/publishing/standards/third-party-signature-verification.mdx Heading/title base-form; formatting normalization touched top-of-file.
en/develop-plugin/publishing/standards/privacy-protection-guidelines.mdx Formatting normalization for label lines.
en/develop-plugin/publishing/marketplace-listing/release-to-dify-marketplace.mdx Divider removal.
en/develop-plugin/publishing/marketplace-listing/release-overview.mdx Title base-form.
en/develop-plugin/publishing/marketplace-listing/release-by-file.mdx Heading base-form.
en/develop-plugin/features-and-specs/plugin-types/tool.mdx Heading base-form.
en/develop-plugin/features-and-specs/plugin-types/persistent-storage-kv.mdx Heading base-form.
en/develop-plugin/features-and-specs/plugin-types/model-schema.mdx Divider removal.
en/develop-plugin/features-and-specs/advanced-development/reverse-invocation-tool.mdx Heading base-form.
en/develop-plugin/features-and-specs/advanced-development/reverse-invocation-node.mdx Heading base-form.
en/develop-plugin/features-and-specs/advanced-development/reverse-invocation-app.mdx Heading base-form + label formatting normalization.
en/develop-plugin/features-and-specs/advanced-development/customizable-model.mdx Divider removal + heading base-form + label formatting normalization.
en/develop-plugin/dev-guides-and-walkthroughs/tool-plugin.mdx Heading base-form.
en/develop-plugin/dev-guides-and-walkthroughs/develop-md-exporter.mdx Title base-form.
en/develop-plugin/dev-guides-and-walkthroughs/develop-a-slack-bot-plugin.mdx Heading base-form + label formatting normalization.
en/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider.mdx Divider removal + formatting normalization for example labels.
en/develop-plugin/dev-guides-and-walkthroughs/cheatsheet.mdx Heading base-form + label punctuation normalization.
en/develop-plugin/dev-guides-and-walkthroughs/agent-strategy-plugin.mdx Heading base-form.
.claude/skills/dify-docs-guides/SKILL.md Points post-writing verification to writing-guides/index.md.
.claude/skills/dify-docs-env-vars/SKILL.md Points post-writing verification to writing-guides/index.md.
.claude/skills/dify-docs-api-reference/SKILL.md Collapses a formatting note + points verification to writing-guides/index.md.

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

Comment thread en/develop-plugin/publishing/standards/third-party-signature-verification.mdx
Comment thread ja/use-dify/workspace/team-members-management.mdx Outdated
Comment thread ja/use-dify/nodes/loop.mdx Outdated
Comment thread ja/use-dify/publish/developing-with-apis.mdx Outdated
Comment thread ja/use-dify/workspace/model-providers.mdx Outdated
Comment thread ja/use-dify/workspace/model-providers.mdx Outdated
Comment thread ja/use-dify/workspace/model-providers.mdx Outdated
Comment thread ja/use-dify/workspace/model-providers.mdx Outdated
Comment thread ja/use-dify/workspace/model-providers.mdx Outdated
Comment thread en/develop-plugin/publishing/standards/third-party-signature-verification.mdx Outdated
RiskeyL and others added 3 commits April 17, 2026 21:42
@RiskeyL @claude
style: convert -ing headings to base form across en docs
279f713 
Applies the formatting guide's heading verb rule to ~111 headings and frontmatter titles: `Creating X` becomes `Create X`, `Publishing the Plugin` becomes `Publish the Plugin`, and so on. Preserves noun-phrase gerund headings that name a concept or feature (`Troubleshooting`, `Getting Started`, `Monitoring Data List`, `Streaming Output`, etc.) and skips heading-less gerunds used as adjectives (`Publishing Methods`, `Mounting & Volumes`). Heading numeric prefixes like `### 6.` are handled before verb detection. Also fixes two pre-existing missing-space issues on numbered headings in embedding-in-websites.mdx.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@RiskeyL @claude
feat: add English and CJK format-check skills
40eceea 
Adds two post-writing verification skills under .claude/skills/. Each combines a Python linter for mechanical rules with a SKILL.md prose section for judgment-call rules, following the same pattern as dify-docs-terminology-check. The English skill enforces every rule in writing-guides/formatting-guide.md. The CJK skill covers general rules plus the Chinese-specific rules in tools/translate/formatting-zh.md and the Japanese-specific rules in tools/translate/formatting-ja.md, auto-selecting the rule set based on the file path. Both linters skip fenced code blocks, inline code spans, and markdown link syntax where appropriate, and they exempt the translation disclaimer from the cross-language link check so zh/ja pages can continue to link back to their English source.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@RiskeyL @claude
docs: centralize post-writing verification in writing-guides index
2ce5692 
Moves the canonical list of post-writing checks into writing-guides/index.md so it lives in one place, adds the two new format-check skills to that list, and shortens the Post-Writing Verification section in each writing skill (guides, api-reference, env-vars) to a one-line pointer. Also unwraps a pre-existing hard-wrapped paragraph in the api-reference skill's Cross-API Links section.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@RiskeyL RiskeyL force-pushed the chore/bulk-cleanup branch from f7a8e31 to 2ce5692 Compare April 17, 2026 13:48
@RiskeyL @claude
fix: address Copilot review comments
d864488 
Applies twelve fixes raised in the PR review:

- Corrects the "Veriyfing" typo in a newly-renamed en heading and updates it to the imperative base form (Verify).
- Removes a stray empty secondary frontmatter block from the same file.
- Restores four garbled translation strings that were flagged by the reviewer (ja loop-variable description, ja conversation_id bullet, zh team-member access description, zh annotation-threshold sentence).
- Repairs an unbalanced bold markup in ja/use-dify/workspace/team-members-management.mdx introduced by the earlier bold-colon relocation pass.
- Converts half-width colons to full-width `：` after bold labels adjacent to CJK across 26 ja and 2 zh files (174 occurrences). The earlier bold-colon pass moved the colons outside `**...**` but left them half-width; Japanese and Chinese prose use `：` next to CJK.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 17, 2026 14:11
Copilot AI reviewed Apr 17, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 188 out of 190 changed files in this pull request and generated 9 comments.

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

Comment thread .claude/skills/dify-docs-format-check-en/check-format-en.py Outdated
Comment thread ja/self-host/troubleshooting/integrations.mdx
Comment thread ja/use-dify/workspace/team-members-management.mdx Outdated
Comment thread en/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx Outdated
Comment thread .claude/skills/dify-docs-format-check-cjk/check-format-cjk.py Outdated
Comment thread ja/use-dify/workspace/personal-account-management.mdx Outdated
Comment thread zh/self-host/troubleshooting/integrations.mdx
Comment thread en/develop-plugin/dev-guides-and-walkthroughs/develop-md-exporter.mdx Outdated
Comment thread en/use-dify/publish/webapp/embedding-in-websites.mdx
@RiskeyL @claude
fix: address second round of Copilot review comments
361fa57 
Covers nine findings from the follow-up review:

- Extends the bold-colon width fix to any `**...**:` pattern on a line containing CJK, not only when the bolded text itself contains CJK. Catches 34 occurrences in 11 ja and zh files such as `**CentOS**:`, `**Windows**:`, and `- **Professional**:` where the bolded label is Latin but the surrounding prose is Japanese or Chinese.
- Replaces `左上角` with `左上` in three ja files. The original translation carried over the Chinese term instead of using the natural Japanese form.
- Unquotes 99 frontmatter values across 56 en files that were wrapped in single or double quotes without any `: ` in the value. Converts the four single-quoted values to unquoted, matching the new frontmatter quoting rule documented in the formatting guide.
- Converts one stray `**Vector Search Settings**：` in en/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx back to `:` so English prose uses half-width punctuation.
- Relaxes `_yaml_needs_quotes()` in both format-check linters to match the documented rule (quote only when the value contains `: `). The previous stricter check flagged cases the guide intentionally left unquoted, which would make the skills report violations that the guide does not treat as errors.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@RiskeyL RiskeyL merged commit 23905eb into main Apr 17, 2026
2 of 3 checks passed
@RiskeyL RiskeyL deleted the chore/bulk-cleanup branch April 17, 2026 14:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

Assignees

No one assigned

Labels

documentation Improvements or additions to documentation size:XXL This PR changes 1000+ lines, ignoring generated files.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@RiskeyL