Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Generieren von Dokumentation mit Amazon Q Developer
Amazon Q Developer hilft Ihnen dabei, Ihren Code zu verstehen und die Dokumentation auf dem neuesten Stand zu halten, indem es READMEs für Ihren Code generiert.
Amazon Q kann neue Dokumentation erstellen und bestehende Dokumentation in Ihrer Codebasis aktualisieren. Durch die Analyse Ihres Projekts, Ihrer Codeobjekte und Abhängigkeiten innerhalb Ihrer Codebasis kann Amazon Q komplexe Codierungskonzepte dokumentieren und die Dokumentation auf der Grundlage neuer Codeänderungen aktualisieren.
Um Dokumente zu generieren, öffnen Sie ein Projekt oder einen Arbeitsbereich in Ihrer IDE und nehmen /doc am Chat teil. Nachdem Sie die Art der Dokumentationsaktualisierung ausgewählt haben, an der Sie arbeiten möchten, analysiert Amazon Q Ihren Code, generiert Dokumentation und stellt eine Übersicht über die vorgenommenen Änderungen bereit. Sie können die vorgeschlagenen Änderungen akzeptieren oder Feedback zu weiteren Änderungen geben, die Amazon Q vornehmen soll.
Informationen IDEs zur Unterstützung dieser Funktion finden Sie unterUnterstützte IDEs. Informationen zu den unterstützten Sprachen finden Sie unterSprachunterstützung für die Dokumentationserstellung mit /doc.
Themen
Anwendungsfälle
Amazon Q kann die folgenden Aufgaben vom Chat-Panel in der IDE aus ausführen.
-
Neue Dokumentation erstellen — Amazon Q kann basierend auf dem Code im ausgewählten Ordner neue READMEs für Ihr Projekt erstellen. Wenn Sie bereits eine README-Datei haben und eine neue README-Datei erstellen möchten, überschreibt Amazon Q Ihre bestehende README-Datei, aktualisiert sie nicht. Sie haben immer noch die Möglichkeit, den neuen Inhalt zu überprüfen, bevor Amazon Q Ihre ursprüngliche README-Datei überschreibt.
-
Nehmen Sie spezifische Aktualisierungen vor — Sie können die Änderungen, die Amazon Q an Ihrer README-Datei vornehmen soll, in natürlicher Sprache beschreiben. Sie können dies tun, indem Sie eine bestehende README-Datei aktualisieren und dann die Option wählen, eine bestimmte Änderung vorzunehmen. Nachdem Amazon Q die Dokumentation generiert hat, haben Sie die Möglichkeit, weitere Änderungen zu beschreiben, die Sie vornehmen möchten. Sie können Aktualisierungen wie das Hinzufügen eines Abschnitts, das Entfernen eines vorhandenen Abschnitts oder die Erläuterung eines vorhandenen Abschnitts anfordern.
-
Neuen Code überprüfen und Aktualisierungen der Dokumentation vorschlagen — Nachdem Sie Codeänderungen vorgenommen haben, kann Amazon Q den neuen Code überprüfen und zugehörige Aktualisierungen für Ihre README-Datei vorschlagen.
Unterstützte Dateitypen
Amazon Q überprüft bei der Generierung der Dokumentation Ihren Quellcode und Ihre Konfigurationsdateien, einschließlich, aber nicht beschränkt auf die folgenden Dateitypen:
-
.template-Dateien
-
requirements.txt
-
package.json
-
tsconfig.json
-
Dockerfile
-
.git/config
-
LIZENZ
-
License.md
-
BEITRAGEND
-
CONTRIBUTING.md
Amazon Q filtert Dateien oder Ordner heraus, die in einer .gitignore Datei definiert sind. Wenn Sie Dateien oder Ordner von der Überprüfung im Hinblick auf die Dokumentationserstellung ausschließen möchten, können Sie sie in eine .gitignore Datei in Ihrem Projekt oder Arbeitsbereich aufnehmen.
Kontingente
Bei der Dokumentationsgenerierung mit Amazon Q werden die folgenden Kontingente beibehalten:
-
README-Größe — Die maximale Größe einer README-Datei, die Amazon Q überprüfen oder generieren kann. Wenn eine vorhandene README-Datei dieses Kontingent überschreitet, kann Amazon Q die bestehende Dokumentation nicht aktualisieren. Wenn eine generierte README-Datei dieses Kontingent überschreitet, kann Amazon Q die aktualisierte README-Datei nicht zurückgeben.
-
Größe des Codeprojekts — Die maximale Größe des Projekts oder Arbeitsbereichs, den Amazon Q zur Generierung von Dokumentation verwenden kann.
Auch wenn Sie einen kleineren Ordner auswählen, für den die Dokumentation generiert werden soll, muss das übergeordnete Projekt oder der übergeordnete Arbeitsbereich innerhalb dieses Kontingents liegen.
-
Dokumentgenerierungen pro Aufgabe — Gibt an, wie oft Sie Feedback geben können, um Änderungen an der generierten Dokumentation vorzunehmen, einschließlich der ersten Dokumentgenerierung. Dieses Kontingent wird jedes Mal zurückgesetzt, wenn Sie eine neue Dokumentationsaufgabe starten.
| Ressource | Kontingent |
|---|---|
| README-Größe | 15 KB |
| Größe des Code-Projekts | 200 MB unkomprimiert 50 MB komprimiert |
| Generierungen von Dokumenten pro Aufgabe | 10 |
