ABAP Programmdokumentation

ABAP Programmdokumentation

Hallo zusammen,

ich arbeite in einem relativ kleinem SAP Umfeld. Berufsgenossenschaft, 600 Mitarbeiter, drei Mandanten (andere Berufsgenossenschafen und Unfallkassen).

Als ich mit der Abap Programmierung angefangen habe, habe ich einiges an alten Programmen übernehmen müssen. Leider war keins davon inline Dokumentiert bzw. überhaupt Dokumentiert worden.
Noch nicht einmal eine Grobe Programmanforderung habe ich gefunden.

Also habe ich dann mal damit angefangen und zusammen mit zwei Kollegen ein System der Dokumentation erdacht.

Das sieht im groben ungefähr so aus:
(Für jeden Schritt gibt es ein Formular)

1. Fachabteilung stellt eine Anforderung (Modifikation eines Programms oder Neuerstellung)
2. Anforderung wird geprüft und ggf. genehmigt. Mit Angabe des Verantwortlichen in der IT
3. Programm wird entwickelt / erweitert. (Natürlich mit Inlinedokumentation )
4. Programm wird getestet und abgenommen.

Während des ganzen Vorgangs wird auch eine generelle Programmdokumentation erstellt.
Diese enthält Angaben über Programmablauf (Struktogramme, PAP, etc) Informationen über Bedienung, Eingabedaten, Ausgabedaten etc. etc.

Jetzt meine Frage:

Wie wird das bei euch gemacht?
Vielleicht haben wir ja einen wichtigen Punkt vergessen der uns dann in ein par Jahren auffällt und bei Wartung etc ins schleudern bringen würde.

Gruß aus Kölle und eine schöne, ruhige Woche wünsche ich!

Bei 9,6 von 10 Kunden gibt es zwei Regeln:

* Ein Programm dokumentiert sich durch sein Coding
* Wer Zeit für Dokus hat, hat zu wenig zu tun


SCNR


Ralf

* Wie für Doku nochmal XX PT zahlen, dann muß der Kommentar im Code reichen.

Ullendahl hat geschrieben:Wie ist es denn bei größeren Projekten?

Genauso. Setz dich mit den Realitäten auseinander, ich habe wirklich große Projekte gemacht aber die wenigsten Kunden (und einige entwickeln auf Modulhöhe eigene Lösungen) legen Wert auf Dokumentation. Die muss man schon auf eigene Kosten am WE schreiben, weil die Zeit einem keiner bezahlt.

Eine löbliche Ausnahme war ein Kunde, der eine Branchenlösung entwickelt hat und wo in neuerer Zeit wirklich gut dokumentiert wurde. Man darf sich halt das zehn Jahre alte Coding nicht angucken, weil damals eben noch nicht dokumentiert wurde, aber das fliegt eh nach und nach raus.


Ralf