Difyドキュメントの共同構築へようこそ!このガイドでは、Dify開発者ドキュメントへの貢献プロセスと仕様を説明し、コミュニティメンバーがドキュメントの品質を共同で向上させることを奨励・支援します。
修正したいドキュメントページの下部にある このページを編集する ボタンをクリックしてください。これにより、GitHubの対応するソースファイルに直接リンクします。
修正したいドキュメントページの下部にある このページを編集する ボタンをクリックしてください。これにより、GitHubの対応するソースファイルに直接リンクします。
DifyドキュメントのURLは、GitHubリポジトリ内の相対パスと明確に対応しています。構造に慣れた貢献者は以下を参考にできます:
URL (例) | GitHubリポジトリの相対パス (例) |
---|---|
https://docs.dify.ai/plugin-dev-ja/0111-getting-started-dify-plugin | plugin-dev-ja/0111-getting-started-dify-plugin.mdx |
編集する際は、コンテンツの正確性と明確さに焦点を当ててください。ファイルの先頭にあるFrontmatterメタデータや、末尾の特定のスクリプトや含まれるコンテンツは、通常、コア貢献者または自動化プロセスによって管理・維持されています。
ドキュメントに問題を見つけた場合は、ページにある 問題を報告する ボタンを使用して報告することもできます。正確な問題報告は、コミュニティとプロジェクトの両方にとって重要な貢献です。
ファイルの作成
適切な言語ディレクトリ(例:plugin-dev-ja
)に新しい.mdx
ファイルを作成します。
最初はファイル名を自由に決めることができます(例:my-new-feature.mdx
)が、ファイル名は十分に説明的である必要があります。システムは後で、ドキュメントのメタデータに基づいて標準化されたファイル名を生成します。
コンテンツの作成
Markdown構文ガイドライン
標準の Markdown 構文に従ってください。MDXファイルでは、HTML形式の <!-- comment -->
ではなく、JSX形式のコメント:{/* これはMDXコメントです */}
を使用してください。
Mintlifyコンポーネント
Frontmatter(メタデータ)の追加
各ドキュメントにはFrontmatterメタデータを定義する必要があります:
あなたのコンテンツ貢献は非常に重要です。 完全なFrontmatterを提供できなくても、あなたのPull Requestは歓迎されます。ドキュメントが最終的に標準化されたメタデータを持ち、正常に統合されるようにすることは、コミュニティとコアチームの協力的な取り組みです。
ドキュメントの編集や新規作成が完了したら、GitHubを通じてメインリポジトリにPull Requestを送信してください。コミュニティメンバーとプロジェクトのメンテナーがあなたの貢献をレビューします。
プログラミングのバックグラウンドがなくてもドキュメントに貢献できますか?
もちろんです!ドキュメントへの貢献にプログラミングスキルは必要ありません。Difyについて理解があれば、既存ドキュメントの明確さと正確さを向上させたり、よりユーザーフレンドリーな説明や例を追加したりすることができます。
私の貢献が受け入れられるためにはどうすればよいですか?
コンテンツが明確で正確であり、フォーマットガイドラインに従っていることを確認してください。提出前にスペルと文法をチェックしてください。不確かな場合は、提出前にコミュニティでアイデアを議論することができます。
日本語以外の言語で貢献できますか?
はい!多言語ドキュメントの貢献を歓迎します。ファイルが対応する言語ディレクトリに配置され、Frontmatterで言語コードが正しくラベル付けされていることを確認してください。
Difyコミュニティとドキュメントへの貢献に感謝します!