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 が生成されます。