Welcome to the collaborative construction of Dify documentation! This guide aims to explain the contribution process and specifications for Dify developer documentation, encouraging and assisting community members to collectively improve documentation quality.

​
Updating Existing Documentation

When editing, please focus on the accuracy and clarity of the content. The Frontmatter metadata at the beginning of the file and specific scripts or included content at the end are typically managed and maintained by core contributors or through automated processes.
If you find issues with the documentation, you can also report them to us using the Submit an issue button on the page. Accurate issue reporting is an important contribution for both the community and the project.

​
Creating New Documentation

1

Create the File

Create a new .mdx file in the appropriate language directory (e.g., plugin-dev-en).You can initially name the file as you wish (e.g., my-new-feature.mdx), but the filename must be sufficiently descriptive. The system will later generate a standardized filename based on the document’s metadata.
2

Write the Content

Please follow standard Markdown syntax. In MDX files, use JSX-style comments: {/* This is an MDX comment */}, rather than HTML-style <!-- comment -->.
You can appropriately use components provided by Mintlify to optimize content structure and presentation:
<Note>
  This is an important note.
</Note>

<Warning>
  This is a warning message.
</Warning>

<Card title="Related Resources" icon="book">
  For more information, please refer to related resources...
</Card>
For more components, please refer to the Mintlify components documentation.
3

Add Frontmatter (Metadata)

Each document needs to define Frontmatter metadata:
  • Correctly configured Frontmatter is key to ensuring that the documentation can be accurately indexed, sorted, and correctly displayed and navigated on the documentation website.
  • Your primary task is to contribute high-quality, accurate documentation content.
  • If you are familiar with Dify’s Documentation Frontmatter Metadata Guide, we welcome you to include Frontmatter when submitting.
  • If you’re unsure how to fill in the Frontmatter, or wish to focus on content creation, that’s perfectly fine. You can submit a Pull Request without Frontmatter or with only partial metadata. The community and project core contributors will assist you with subsequent additions, reviews, and optimizations.
Your content contribution is crucial. Even if you don’t provide complete Frontmatter, your Pull Request is still welcome. Ensuring the documentation ultimately has standardized metadata and successful integration is a collaborative effort between the community and the core team.

​
Submitting Your Contribution

After completing the editing or creation of new documentation, please submit a Pull Request to the main repository through GitHub. Community members and project maintainers will review your contribution.

​
Frequently Asked Questions

Absolutely! Documentation contributions don’t require programming skills. If you have some understanding of Dify, you can help improve the clarity and accuracy of existing documentation, or add more user-friendly explanations and examples.
Ensure your content is clear, accurate, and follows our formatting guidelines. Check for spelling and grammar before submission. If you’re uncertain, you can discuss your ideas in the community before submitting.
Yes! We welcome multilingual documentation contributions. Please ensure your files are placed in the corresponding language directory and correctly labeled with the language code in the Frontmatter.
Thank you for contributing to the Dify community and documentation!
Edit this page | Report an issue