Dify Documentation Guides

Before Starting

Read these files before beginning any documentation task:

1. writing-guides/style-guide.md — voice, tone, writing patterns
2. writing-guides/formatting-guide.md — MDX formatting, Mintlify components
3. writing-guides/glossary.md — standardized terminology

When optimizing Chinese or Japanese translations, also read:

• tools/translate/formatting-zh.md or tools/translate/formatting-ja.md

Reader Personas

Adjust tone and assumed knowledge based on the document path:

en/use-dify/

Product users building AI applications on Dify. Mix of developers and non-technical users. Assume basic AI familiarity but not infrastructure or deep coding knowledge. Explain technical concepts when they appear. Prioritize task completion and outcomes.