Erläuterungen aktuell halten — Noea Code Dokumentation

Prüfen Sie nach Änderungen an Absicht oder Code, ob die Erläuterungen noch zutreffen. Mit Erläutern in der Seitenleiste bearbeiten Sie projektweit prüfbedürftige Erläuterungen; mit Untersuchung an einem Absatz prüfen Sie einen einzelnen Inhalt.

Änderungen erkennen

Status	Bedeutung	Nächster Schritt
Zu untersuchender Inhalt	Neue oder geänderte Formulierungen haben noch keine eigene Erläuterung.	Sichern und untersuchen. Ist die Anforderung noch nicht erfüllt, zuerst implementieren.
Erläuterung des vorherigen Textes	Der Absatz wurde geändert, die Notiz erläutert aber noch die frühere Formulierung.	Textunterschiede prüfen und erneut untersuchen.
Möglicherweise veraltet	Von der Erläuterung gelesene oder zitierte Dateien wurden geändert.	Geänderte Dateien ansehen und Erläuterung erneut prüfen.
Keine Änderungen gefunden	Kein Inhalt wartet auf Untersuchung oder ist als möglicherweise veraltet markiert.	Nach Bedarf weiterlesen oder konkrete Fragen prüfen.

„Möglicherweise veraltet“ bedeutet nicht zwangsläufig eine falsche Schlussfolgerung; eine Dateiänderung kann unbeteiligt sein. „Keine Änderungen gefunden“ beweist weder bestandene Tests noch vollständige Funktionen.

Einen Absatz untersuchen

Sichern Sie das Dokument, bewegen Sie den Zeiger über den Absatz und wählen Sie links Untersuchung. Eine vorhandene Randnotiz kann auch Erneut untersuchen anbieten.

Dadurch wird nur die Erläuterung des ausgewählten Inhalts aktualisiert. Solange dieser ungesicherte Änderungen besitzt, ist die Untersuchung nicht verfügbar; Noea fordert zum vorherigen Sichern auf.

Untersuchen Sie beispielsweise nach einer Codeänderung gegen doppelte Belohnungen die zugehörige Regel, um zu prüfen, ob ihre Erläuterung die aktuelle Implementierung beschreibt.

Erläuterungen im gesamten Projekt aktualisieren

Klicken Sie in der Seitenleiste auf Erläutern, um wartende Inhalte und Erläuterungen mit geänderten Nachweisdateien zu prüfen. Ohne geöffnetes Projekt, bei schreibgeschütztem Projekt oder ohne verknüpften Implementierungsordner ist die Aktion nicht verfügbar.

Eine manuell gestartete Erläuterungsaufgabe öffnet einen Chat mit Phasen, Fortschritt und Einzelergebnissen. Während sie läuft, können Sie dort keine normalen Nachrichten senden, jedoch andere Chats im Projekt nutzen.

Klappen Sie danach die Ergebnisse auf: Welche Erläuterungen wurden geändert, welche gelten weiterhin und welche Prüfungen schlugen fehl oder blieben unvollständig? Ein beendeter Lauf bedeutet nicht, dass jede Prüfung erfolgreich war.

Verstehen, was „Erläutern“ geprüft hat

„Erläutern“ vergleicht Absicht und Code und prüft absatzbezogene sowie lokale Erläuterungen. Zutreffende Inhalte bleiben erhalten, korrekturbedürftige werden aktualisiert; es wird nicht unbedingt jede Erläuterung neu geschrieben.

Eine aktualisierte Erläuterung bedeutet nicht, dass Tests erneut ausgeführt wurden. Fordern Sie zur Verhaltensprüfung die gewünschten Checks in einem normalen Chat an und untersuchen Sie anschließend den relevanten Inhalt. Erläuterungen und Nachweise lesen erklärt die Beurteilung des Prüfumfangs.

Automatische Auslöser kennen

Einstellungen → Aktuelles Projekt → Automatisierung → Nach dem Implementieren automatisch erläutern ist standardmäßig aktiviert. Die wichtigsten Auslöser:

Aktion	Automatisches Erläutern
Einen absichtsändernden Vorschlag annehmen, der noch implementiert werden muss.	Nach regulärem Ende seiner Implementierungsaufgabe.
Einen absichtsändernden Vorschlag annehmen, den die Implementierung bereits erfüllt.	Nach der Annahme.
Arbeit über „Umsetzen“ in der Seitenleiste starten.	Nach regulärem Ende des ersten Durchlaufs.
Einen Neuordnungsplan annehmen, der Absichtstext ändert.	Nach der Annahme, unabhängig von der obigen Einstellung.
Nur Dateinamen oder Ordnerstruktur neu ordnen.	Wird nicht ausgelöst.
Nur Code in einem normalen Chat ändern, „Direkt implementieren“ wählen oder Implementierung fehlschlagen lassen bzw. stoppen.	Wird nicht ausgelöst; „Erläutern“ manuell starten.

Automatisches Erläutern läuft im Hintergrund, ohne einen normalen Chat zu erstellen. Setzen Sie Ihren ursprünglichen Chat fort und prüfen Sie den Fortschritt unter Läufe.

Aufzeichnungen prüfen und erneut ausführen

Im Bereich Läufe der Seitenleiste bleiben Erläuterungsaufgaben erhalten. Klappen Sie eine Aufgabe auf, um schreibgeschützte Aufzeichnungen ihrer Ausführungen zu lesen. Sie bleiben auch nach Chatwechsel oder App-Neustart verfügbar.

Wählen Sie nach Fehler oder Unterbrechung Erneut ausführen. Vorhandene Erläuterungen bleiben erhalten. Prüfen Sie nach dem neuen Lauf, ob zuvor fehlgeschlagene oder unvollständige Punkte bearbeitet wurden.

Agenten für einzelne Vorgänge wählen

Welchen Agenten „Erläutern“ verwendet, hängt vom Start der Aufgabe ab. Agents, Modelle und Nutzung beschreibt die Einstellungen und ihren Geltungsbereich.

Wenn Erläuterungen nicht aktualisiert werden, lesen Sie Fehlerbehebung und häufige Fragen.