Contribution Guide
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
At the bottom of the documentation page you wish to modify, click the Edit this page button. This will directly link to the corresponding source file on GitHub.
At the bottom of the documentation page you wish to modify, click the Edit this page button. This will directly link to the corresponding source file on GitHub.
Dify documentation URLs have a clear correspondence with their relative paths in the GitHub repository, which can be referenced by contributors familiar with the structure:
| URL (example) | GitHub Repository Relative Path (example) |
|---|---|
https://docs.dify.ai/plugin-dev-en/0111-getting-started-dify-plugin | plugin-dev-en/0111-getting-started-dify-plugin.mdx |
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
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.
Write the Content
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
Thank you for contributing to the Dify community and documentation!