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.
Bewährte Methoden für die Dokumentationserstellung mit Amazon Q Developer
Um die Ergebnisse der Dokumentationserstellung mit Amazon Q zu verbessern, folgen Sie diesen bewährten Methoden:
-
Amazon Q kann Dokumentation für jede Codemenge innerhalb des Größenkontingents für Codeprojekte generieren. Bei sehr großen Repositorys dauert die Generierung der Dokumentation jedoch länger und ist möglicherweise weniger spezifisch. Wenn Sie über ein großes Repository verfügen, sollten Sie erwägen, Dokumentation für eine Teilmenge des Codes oder eine einzelne Datei anzufordern, um genauere Ergebnisse zu erzielen.
-
Die Qualität der von Amazon Q generierten Dokumentation kann verbessert werden, wenn Ihr Code gut kommentiert und organisiert ist, gute Benennungskonventionen für Programmierentitäten hat und andere Standardkodierungskonventionen befolgt.
-
Amazon Q erstellt die qualitativ hochwertigste Dokumentation für Code, der in einer oder mehreren der unterstützten Sprachen geschrieben wurde. In anderen Sprachen geschriebener Code spiegelt sich möglicherweise nicht in der generierten Dokumentation wider oder könnte zu einer Dokumentation von geringerer Qualität führen. Weitere Informationen zu Sprachen finden Sie unterSprachunterstützung für die Dokumentationserstellung.
-
Wenn Sie bestimmte Änderungen an einer Datei README in natürlicher Sprache beantragen möchten, können Sie dies tun, indem Sie eine bestehende Version aktualisieren README und dann die Option wählen, eine bestimmte Änderung vorzunehmen. Nachdem Amazon Q die Dokumentation generiert hat, können Sie auch Änderungen vornehmen und beschreiben, welche Aktualisierungen Amazon Q vornehmen soll.
-
Beachten Sie bei der Beschreibung der Aktualisierungen, die Amazon Q an Ihrer Dokumentation vornehmen soll, Folgendes:
-
Die Beschreibung der Änderungen sollte die Abschnitte enthalten, die Sie ändern möchten, den Inhalt, den Sie hinzufügen oder entfernen möchten, sowie spezifische Probleme, die behoben werden müssen.
-
Die Änderungen sollten sich darauf beziehen, wie sich die Projektfunktionalität in der README widerspiegelt.
-
Inhalte, auf die Sie sich beziehen, sollten in Ihrer Codebasis verfügbar sein.
-
-
Amazon Q hat keinen Zugriff auf private oder interne Plattformen. Amazon Q hat möglicherweise auch keine Kenntnisse über Tools oder Software von Drittanbietern oder spezielle Tools in Ihrem Code. Wenn Ihr Code Ressourcen enthält, auf die Amazon Q nicht zugreifen kann oder mit denen Amazon Q nicht vertraut ist, wird dieser Code nicht dokumentiert. Sie können den Inhalt manuell bearbeitenREADME, um Inhalte einzuschließen, die Amazon Q nicht generieren kann.
