Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Avant de commencer, assurez-vous d'avoir installé Amazon Q dans un IDE qui prend en charge la génération de documentation. Pour de plus amples informations, veuillez consulter Installation de l'extension ou du plugin Amazon Q Developer dans votre IDE.
Pour générer ou mettre à jour READMEs avec Amazon Q dans l'IDE, suivez la procédure suivante :
-
Ouvrez votre IDE sur lequel l'extension Amazon Q est installée.
-
Choisissez l'icône Amazon Q pour ouvrir le panneau de discussion. Saisissez
/doc. -
Un nouvel onglet de discussion s'ouvre. Amazon Q vous invite à créer un nouveau fichier README pour votre code ou à mettre à jour un fichier README existant.
-
Choisissez le type de tâche de documentation sur laquelle vous souhaitez travailler.
Si vous mettez à jour un fichier README existant, choisissez si vous souhaitez qu'Amazon Q mette à jour votre fichier README avec les modifications récentes du code ou si vous souhaitez apporter des modifications spécifiques à votre fichier README par Amazon Q.
-
Amazon Q vous invite à confirmer que vous souhaitez générer de la documentation pour le dossier actuellement ouvert dans votre IDE, ou vous pouvez choisir un nouveau dossier.
Si vous avez choisi d'apporter des modifications spécifiques à votre fichier README, décrivez en détail les mises à jour que vous souhaitez qu'Amazon Q apporte. Pour des idées sur les éléments à inclure dans votre description, consultezBonnes pratiques.
Amazon Q commence à générer votre documentation. Si le dossier de votre projet contient des infrastructure-as-code fichiers, Amazon Q créera des diagrammes d'infrastructure qui seront générés dans les
infra.svgfichiers dudocsdossier et référencés dans le fichier README. -
Une fois qu'Amazon Q a généré vos documents, il fournit une différence avec toutes les modifications. Vous pouvez consulter les différences, puis choisir Accepter dans le chat pour mettre à jour votre fichier README en place.
Si vous souhaitez apporter des modifications à la documentation générée, choisissez Apporter des modifications. Vous pouvez ensuite décrire ce que vous souhaitez qu'Amazon Q modifie et il générera un fichier README mis à jour.
