注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
各ドキュメントリポジトリは、そこから公開されるカスタムドキュメントの「真実の源」です。各ビルドは、現在ドキュメントリポジトリにあるファイルのみを公開します。以前に公開されたドキュメントリポジトリからのコンテンツは、プラットフォーム内のカスタムドキュメントサイトから削除されます。
例: 製品Aに関するカスタムドキュメントを作成して公開したとします。その後、製品Aのファイルをドキュメントリポジトリから削除し、製品Bおよび製品Cの新しいドキュメントを追加します。次回のマージと公開後、プラットフォーム内カスタムドキュメントには製品Bと製品Cのドキュメントが含まれますが、製品Aのドキュメントは含まれなくなります。
カスタムドキュメントは、master
ブランチでビルドが実行されると公開されます。他のブランチではプラットフォーム内カスタムドキュメントは公開されません。コミットのチェックで公開プロセスのステータスを確認できます。
理想的なワークフローは、新しいブランチを作成し、目的のドキュメント内容を作成または編集し、その後master
ブランチでプルリクエスト(PR)を開くことです。カスタムドキュメントのPRをmaster
にマージすると、ビルドがトリガーされてドキュメントが公開されます。
master
ブランチに変更をコミットするだけでは、これらの変更がプラットフォーム内カスタムドキュメントに反映されることはありません。ビルドが必要です。
公開後、以前に公開されたファイルの変更はすぐに表示されます。新しいドキュメントページの追加、ドキュメントページの削除、または全体のコンテンツ構造の変更は、カスタムドキュメントサービスがドキュメント状態を再コンパイルした後に表示されます。デフォルトでは、これは1時間ごとに行われますが、管理者がこの間隔を調整することができます。
ドキュメントコードリポジトリを削除するだけでは、プラットフォーム内カスタムドキュメントからドキュメントを削除または公開停止することはできません。カスタムドキュメントページを削除または公開停止するには、不要なファイルをドキュメントリポジトリから削除し、その後リポジトリを再公開する必要があります。これにより、不要なドキュメントコンテンツが公開停止されます。
docs
フォルダーからすべてのコンテンツを削除し、リポジトリを再公開するまで、公開されたドキュメントコードリポジトリを削除しないでください。
削除後、個々のカスタムドキュメントページはすぐに消えます。削除されたドキュメントのホームページエントリと目次は、ドキュメントサービスが内部でドキュメント状態を再コンパイルした後に消えます。デフォルトでは、これは毎時間行われますが、変更が早く反映されるように管理者がこの間隔を調整することができます。