使用 Amazon Q Developer 產生和更新 READMEs - Amazon Q Developer

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Amazon Q Developer 產生和更新 READMEs

注意

您可以要求 在聊天中直接產生文件。如果您使用 /doc，您的請求將重新導向至聊天。嘗試詢問 generate documentation for my application。

開始使用之前，請確定您已在支援產生文件的 IDE 中安裝 Amazon Q。如需詳細資訊，請參閱在 IDE 中安裝 Amazon Q Developer 延伸模組或外掛程式。

若要在 IDE 中使用 Amazon Q 產生或更新 READMEs，請完成下列程序：

  1. 開啟已安裝 Amazon Q 延伸模組的 IDE。

  2. 選擇 Amazon Q 圖示以開啟聊天面板。輸入 /doc。

  3. 新的聊天索引標籤隨即開啟。Amazon Q 會提示您為程式碼建立新的 README 或更新現有的 README。

  4. 選擇您要處理的文件任務類型。

    如果您更新現有的 README，請選擇是否希望 Amazon Q 使用最近的程式碼變更來更新 README，或者如果您想要提供 Amazon Q 應該對 README 進行的特定變更。

  5. Amazon Q 會提示您確認是否要為 IDE 中的目前開啟資料夾產生文件，或者您可以選擇新的資料夾。

    如果您選擇對 README 進行特定變更，請詳細說明您希望 Amazon Q 進行哪些更新。如需描述中要包含哪些內容的想法，請參閱 最佳實務。

    Amazon Q 會開始產生您的文件。如果您的專案資料夾包含infrastructure-as-code檔案，Amazon Q 會建立基礎設施圖表，輸出至docs資料夾中infra.svg的檔案，並在 README 中參考。

  6. 在 Amazon Q 產生您的文件之後，它會提供任何變更的差異。您可以檢閱差異，然後在聊天中選擇接受，以正確更新您的 README。

    如果您想要對產生的文件進行變更，請選擇進行變更。然後，您可以描述您希望 Amazon Q 變更的內容，並產生更新的 README。