Verbesserung
Wichtig
Detail
Fehlerbehebung
Detail
Die Properties (page.properties) für eine Dokumentationsseite enthalten einen Eintrag source=my.module, in dem das Modul hinterlegt ist, aus dem die Seite initial geladen wurde. Bei einem Export in die Entwicklungsumgebung wird eine Seite nur dann exportiert, wenn das in den Eigenschaften der Seite angegebene Modul auch exisitiert.
Der Export einer neuen Dokumentationsseite erfolgt immer in das Top-Level-Modul. Verschiebt man eine neue Seite anschließend in der Entwicklungsumgebung in ein anderes Module (weil man z.B. am Beispiel von tl-demo eine neue TL-Script-Funktion dokumentiert hat), vergisst man sehr wahrscheinlich das source-Property anzupassen. Bei einem erneuten Export in die Entwicklungsumgebung hat das zur Folge, dass die Seite wieder in das angegebene Module (tl-demo) exportiert wird und man anschließend die Seite doppelt in der Entwicklungsumgebung hat.
Verbesserung
Der de-facto Ort einer Dokumentationsseite gewinnt beim Import gegenüber dem in ihren Properties gespeicherten Modul. Nach einem Refactoring in der Entwicklungsumgebung und einem Import und Re-Export in/aus der Anwendung sind spätestens alle Settings wieder konsistent.
Test
- Anwendung starten.
- Dokumentation exportieren.
- Es darf keine Änderungen geben.