Bestehende Software dokumentieren
Bei der Übernahme älterer Software fehlen oft verständliche Erklärungen. Modulweise Entwürfe geben dir eine Grundlage für den Abgleich mit dem Code.
Werkzeug im Beispiel
Liest den vorhandenen Java-Code und entwirft Erläuterungen für die fachliche Prüfung.
- Beschrieben von
- Aburok
- Veröffentlicht auf
- aburok.de
- Quelle geprüft
Der dokumentierte Fall
Module einer älteren Java-Anwendung erklären und Dokumentationsentwürfe prüfen.
Ablauf aus der Quelle
- Quellcode
- Rohdokumentation
- fachliche Prüfung
Redaktionell zusammengefasst aus der Quelle.
Was die Quelle zeigt
Aburok berichtet über modulweise Entwürfe mit anschließender Korrektur.
Was offen bleibt
Anonymisiertes Kundenprojekt; Aussagen müssen am Code geprüft werden.
UNSERE EINORDNUNG
Für wen könnte das passen?
Du übernimmst eine gewachsene Anwendung und brauchst nachvollziehbare Orientierung.
Voraussetzungen
Repository-Zugriff und Erfahrung mit der Anwendung.
Dein Prüfpunkt
Technische Aussagen prüfen, fehlenden Fachkontext ergänzen und Dokumentation mit Änderungen pflegen.
Aufwand und Daten
Entwicklungskenntnisse
Prüfe Modellzugang, Datenverarbeitung und Betreuungsbedarf für deinen Aufbau. Vollständige Betriebskosten sind in der Quelle offen.
Das Beispiel im Detail
Fiktives Beispiel zur Veranschaulichung
Ein älteres Modul berechnet Versandkosten. Es gibt Quellcode und Tests, aber kaum verständliche Dokumentation.
Gliederungsentwurf: Eingaben · Berechnungsregeln · Abhängigkeiten · Sonderfälle. Jede Aussage erhält beim Review einen Abgleich mit Code und Tests.
Das Werkzeug verstehen
Zugang, Kosten und Europa-Verfügbarkeit