Inhalt der Dokumentation12 / 16

Im Alltag12 / 16

Wachsende Absichtsdokumente ordnen

Auf dieser Seite

Wenn Dokumente sich wiederholen, verwandte Themen auseinanderdriften oder Inhalte zusammengeführt werden sollen, nutzen Sie Quelle ordnen. Der Agent schlägt einen Neuordnungsplan für alle Absichtsdokumente vor; Sie entscheiden nach Prüfung über seine Anwendung.

Sichern Sie zuerst Ihre aktuellen Änderungen. Die Absichtsdokumente bleiben unverändert, bis Sie den Plan annehmen.

Neuordnung starten

Bewegen Sie den Zeiger über die Überschrift „Absichten“ in der Seitenleiste, klicken Sie auf die Ordnen-Schaltfläche und bestätigen Sie. Noea öffnet einen Neuordnungschat mit Fortschritt und Ausführungsverlauf.

Vorher können Sie unter Einstellungen → Aktuelles Projekt → Aktionen Agent, Modell und Denkaufwand für Quelle ordnen wählen.

Während der Ausführung erscheint Neuordnung in der Seitenleiste mit Dokumentbaum und Änderungsmarkierungen. Öffnen Sie ein Dokument, um den entstehenden Entwurf anzusehen. Die Vorschau aktualisiert sich mit dem Fortschritt und ist nicht bearbeitbar.

Gesamtänderungen prüfen

Nach Abschluss zeigt die Neuordnungskarte Zusammenfassung, Änderungsstatistik, Vergleich der Zeichenzahlen und Empfehlungen. Prüfen Sie vor dem Lesen, welche Dateien betroffen sind und was zusammengeführt oder verschoben wurde.

Der Bereich „Neuordnung“ zeigt die vorgeschlagene Hierarchie mit Markierungen für Ergänzungen, Entfernungen, Umbenennungen und Verschiebungen. Klicken Sie zur Prüfung auf einen Eintrag.

Neu geordneter Entwurf und aktuelle Dokumente sind getrennte Ansichten und können nebeneinander verglichen werden.

Vorgeschlagene Löschungen prüfen

Die Neuordnungsprüfung zeigt das vollständige vorgeschlagene Dokument schreibgeschützt. Zur Löschung vorgesehene Inhalte bleiben an ihrem Platz, hellrot hinterlegt, durchgestrichen und mit einer Begründung versehen.

Bei Annahme werden vorgeschlagene Löschungen standardmäßig entfernt. Gilt eine Anforderung weiterhin, wählen Sie Behalten. Für eine ganze Datei können Sie Gesamte Datei behalten wählen. Diese Entscheidungen werden gespeichert und bleiben nach App-Neustarts erhalten.

Die untere Navigation führt dateiübergreifend durch vorgeschlagene Löschungen. Listenpunkte und Tabellenzeilen behalten ihre ursprüngliche Struktur, damit Sie sie im Zusammenhang beurteilen können.

Mit aktuellen Dokumenten vergleichen

Wählen Sie Mit Original vergleichen, um das aktuelle Dokument auf der anderen Seite zu öffnen. Vereint ein Entwurf mehrere Dateien, wählen Sie die zu vergleichende Quelle.

Achten Sie besonders auf diese Punkte:

  • Ging beim Zusammenführen oder Umformulieren eine Bedingung verloren, etwa die einmalige Belohnung innerhalb einer Serie?
  • Wurden Regeln für unterschiedliche Situationen vermischt und dadurch ihre Geltungsbereiche unklar?
  • Wurden gültige Anforderungen entfernt? Eine fertige Funktion ist kein Grund, ihre Absicht zu löschen.
  • Ist die Formulierung verständlich, ohne einmalige Arbeitsanweisungen zu dauerhaften Anforderungen zu machen?

Neuordnung soll die Darstellung verbessern, nicht stillschweigend Anforderungen ändern. Den Unterschied zwischen Entfernen einer Bedingung und Entfernen einer Funktion erklärt Wichtige Absichten formulieren.

Den ganzen Plan annehmen oder ablehnen

Klicken Sie nach der Prüfung auf Annehmen. Haben Sie Inhalte zum Behalten gewählt, zeigt die Schaltfläche deren Anzahl. Die Annahme gilt für den gesamten Plan einschließlich Text- und Strukturänderungen.

Ablehnen lässt den Plan unangewendet. Sie können die aktuellen Dokumente weiter bearbeiten und später neu ordnen.

Die Annahme eines Plans mit Textänderungen aktualisiert automatisch die Implementierungserläuterungen. Reine Änderungen an Dateinamen oder Ordnerstruktur lösen „Erläutern“ nicht aus. Diese automatische Aktualisierung ist unabhängig von „Nach dem Implementieren automatisch erläutern“. Zur Konfiguration siehe Agents, Modelle und Nutzung.

Mit einem veralteten Plan umgehen

Ändert sich die aktuelle Absicht nach Erstellung des Plans, wird er veraltet. Die Annahme ist deaktiviert; stattdessen wird Neu ordnen angeboten. Auch beim Sichern eines aktuellen Dokuments während der Prüfung warnt Noea, dass dies den Plan ungültig machen kann.

Um den Entwurf weiter umzuformulieren, lehnen Sie den Plan ab, bearbeiten die aktuellen Dokumente und ordnen erneut. Anders als neuer Text in einem gewöhnlichen Vorschlag ist der Text der Neuordnungsprüfung nicht direkt bearbeitbar.

Es kann immer nur ein Neuordnungsplan auf Prüfung warten. Beim Start eines weiteren weist Noea darauf hin, dass der alte verworfen wird.

Prüfen Sie anschließend, ob Ihre Erläuterungen aktualisiert werden müssen.