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