feat: add shared writing guides, documentation skills, and repo infrastructure

[RiskeyL]

Summary

• Add writing-guides/ with shared style guide, formatting guide, and trilingual glossary (with UI Labels section)
• Add 5 Claude Code skills in .claude/skills/: dify-docs-guides, dify-docs-api-reference, dify-docs-env-vars, dify-docs-release-sync,
  dify-docs-reader-test
• Add termbase derivation script (tools/translate/derive-termbase.py) and pre-commit hook (.githooks/) to keep glossary and termbase in sync
• Add language-specific formatting guides for Chinese and Japanese (tools/translate/formatting-zh.md, formatting-ja.md)
• Add translation system overview (tools/translate/translation-system-overview.md)
• Redesign CLAUDE.md as a concise task-routing hub
• Add README.md with contributor guide

Context

Previously, three documentation skills (dify-docs-writer, dify-openapi-standards, dify-env-var-docs) lived in a personal directory and maintained their own terminology, formatting rules, and style guidelines independently. This caused duplication and made team collaboration difficult.

This PR establishes a unified system:

• Shared writing guides (writing-guides/) serve as the single source of truth for style, formatting, and terminology
• Skills are thin, task-specific layers that load the shared guides and add domain-specific overrides
• Glossary is the single source of truth for terminology; the translation pipeline's termbase is auto-derived from it
• Reader personas are defined per documentation path so the AI adjusts tone and assumed knowledge appropriately

[mintlify]

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

Project	Status	Preview	Updated (UTC)
dify-core-product	🟢 Ready	View Preview	Mar 27, 2026, 11:42 AM

[Copilot]

Pull request overview

This PR sets up shared documentation authoring infrastructure for the Dify docs repo—centralizing style/formatting/terminology guidance, codifying Claude “skills” for common doc tasks, and adding tooling to keep the translation termbase derived from the glossary.

Changes:

• Add writing-guides/ (style guide, formatting guide, glossary, and an index that routes tasks to the right skill).
• Add multiple .claude/skills/ for guides, API reference, env vars, release sync, and reader verification.
• Add translation tooling docs + automation helpers (termbase derivation script, pre-commit hook, language-specific formatting guides, translation system overview).

Reviewed changes

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

Show a summary per file

File	Description
writing-guides/style-guide.md	Defines voice/tone and writing patterns for docs.
writing-guides/index.md	Routes contributors to the correct skill and reference guides.
writing-guides/glossary.md	Establishes standardized terminology + UI labels (source of truth).
writing-guides/formatting-guide.md	Defines MDX/Mintlify formatting standards and component usage.
tools/translate/translation-system-overview.md	Documents the end-to-end translation pipeline architecture and workflows.
tools/translate/termbase_i18n.md	Expands/refactors the termbase content used by the translation engine.
tools/translate/formatting-zh.md	Adds Chinese-specific formatting rules for translations.
tools/translate/formatting-ja.md	Adds Japanese-specific formatting rules for translations.
tools/translate/derive-termbase.py	Adds generator to derive termbase_i18n.md from the rich glossary.
README.md	Adds contributor guide and repo usage conventions.
CLAUDE.md	Redesigns instructions into a concise task-routing hub.
.mintignore	Excludes internal guides/config from Mintlify build output.
.githooks/pre-commit	Auto-regenerates and stages the derived termbase when glossary changes.
.claude/skills/dify-docs-release-sync/SKILL.md	Adds a workflow for milestone-based pre-release doc synchronization.
.claude/skills/dify-docs-reader-test/SKILL.md	Adds a “reader persona” verification skill for post-writing review.
.claude/skills/dify-docs-guides/SKILL.md	Adds the primary user-guide writing/review skill referencing shared guides.
.claude/skills/dify-docs-env-vars/verify-env-docs.py	Adds a script to verify env-var docs against .env.example.
.claude/skills/dify-docs-env-vars/deep-dive.md	Adds a deep-dive reference for env var behavior and code trace notes.
.claude/skills/dify-docs-env-vars/SKILL.md	Adds env-var documentation process, conventions, and verification steps.
.claude/skills/dify-docs-api-reference/references/common-mistakes.md	Adds a quick-reference list of common OpenAPI spec issues.
.claude/skills/dify-docs-api-reference/references/codebase-paths.md	Adds mappings between docs/specs and Dify codebase locations.
.claude/skills/dify-docs-api-reference/references/audit-checklist.md	Adds a per-endpoint audit checklist for spec/code fidelity.
.claude/skills/dify-docs-api-reference/SKILL.md	Adds the main OpenAPI editing/auditing skill with strict fidelity rules.

---

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

[Copilot]

Pull request overview

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

---

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