7 comments on “Projektdokumentation von Markus Amshove (mit 100% bewertet)”

1. chena sagt:

   23. Juli 2015 um 21:14:23 Uhr

   Kleine OT-Frage:
   Wird bei euch im Unternehmen wirklich auf deutsch programmiert oder wurden die Codebeispiele entsprechend für die Dokumentation abgeändert?

2. Stefan Macke sagt:

   23. Juli 2015 um 21:28:12 Uhr

   Wir programmieren auf Deutsch. Frameworks, die wir veröffentlichen, werden auf Englisch entwickelt. Und unser Kernsystem ist teilweise in Spanisch geschrieben 🙂

   Wir haben einfach festgelegt, dass für die Domäne der deutschen Krankenversicherung Englisch unsinnig ist. Die übersetzten Begriffe würde niemand verstehen.

3. Kritischer Anwendungsentwickler sagt:

   2. August 2015 um 2:06:06 Uhr

   Herr Macke,

   erklären Sie mir doch bitte einmal, wie man eine Dokumentation mit 15+ sehr textlastigen Seiten und der hier gebotenen Qualität in nur 9 Stunden schreibt.

   Mir ist aufgefallen, dass auch bei der Doku von Frau Feldhaus, die Sie hier zur Verfügung stellen und welche hohe Maßstäbe setzt, die Zeit für ebenjene recht niedrig angesetzt war.

   Ich denke, hier sind ernsthafte Zweifel berechtigt, denn letztendlich ist für die Bewertung die Dokumentation ausschlaggebend und nicht das Projekt selbst. Es hat für mich diesbezüglich den Anschein, als sei die Doku hier und auch bei Frau Feldhaus lediglich ein Nebenschauplatz.

   Auch wenn LaTeX, richtig eingesetzt, die Arbeit erleichtert, so ist der Autor immer noch selbst für den Inhalt, die Formulierungen und die Qualitätssicherung verantwortlich. Ich möchte nicht ausschließen, dass es Menschen gibt, die die Menge des Stoffes in der angegebenen Zeit bewältigen können, vor dem Hintergrund, dass hier im Grunde noch Anfänger am Werk waren, fällt es mir aber schwer, daran zu glauben. Wie sehen Sie das, Herr Macke?

4. Stefan Macke sagt:

   2. August 2015 um 12:39:57 Uhr

   Hallo Herr Kritiker,

   ich beginne mal mit Ihrem letzten Satz, in dem Sie selbst sagen, dass es Menschen gibt, die zu solch einer Leistung fähig wären. Denn beide Dokumentationen stammen von außergewöhnlich guten Auszubildenden, die sowohl ihre Ausbildung verkürzt haben, als auch in der Berufsschule und der IHK-Prüfung hervorragende Leistungen gebracht haben. Einen entsprechenden Beitrag finden Sie hier: Gerda Feldhaus von der IHK Oldenburg als Berufsbeste geehrt.

   Kommen wir aber nun zum eigentlichen Kritikpunkt. Sie haben völlig recht damit, dass die Dokumentation nicht den Anschein macht, dass man sie in 7 Stunden (denn in den genannten 9 Stunden sind auch noch 2 Stunden für die Kunden- und Entwicklerdokumentation enthalten) hätte schreiben können. Allerdings ist das durchaus möglich, wie Sie selbst schon schreiben, da das Ganze „Drumherum“ um den eigentlichen Inhalt in diesem Fall von LaTeX erledigt wird. Wenn man von Null anfängt und sich mit Word erstmal das Dokument zusammenbasteln muss, wird das natürlich deutlich länger dauern. Aber niemand schreibt den Prüflingen vor, welches Textverareitungsprogramm sie zu nutzen haben und dass keine Dokumentvorlagen erlaubt sind. Das wäre ja auch völlig lächerlich, da wir in der IT ja gerade darauf aus sind, nicht ständig das Rad neu zu erfinden und unsere Arbeit zu optimieren und zu automatisieren. Und mit meiner Vorlage für die Projektdokumentation muss von ein paar Feinjustierungen abgesehen nur noch der Inhalt gefüllt werden. Da meine Auszubildenden gleich in den ersten Wochen der Ausbildung eine LaTeX-Schulung bekommen, sind sie nach zwei bzw. zweieinhalb Jahren auch längst keine „Anfänger“ mehr beim Erstellen von Dokumenten. Das gleiche kann man natürlich mit einer entsprechenden Word-Vorlage und -Schulung auch erreichen.

   Was man übrigens nicht vergessen darf: Die gesamten Artefakte in der Dokumentation (z.B. UML-Diagramme, ERM usw.) sind schon in der normalen Projektlaufzeit erstellt und auch vorher entsprechend eingeplant worden. Sie müssen also „nur noch“ in die Dokumentation eingebunden werden.

   Die Anmerkung mit dem Nebenschauplatz verstehe ich nicht so ganz. Sie sagen ja schon, dass die Dokumentation das einzige ist, das die Prüfer bewerten. Daher werden die Prüflinge natürlich sehr viel Wert auf die Dokumentation legen und sie auch von Dritten korrekturlesen lassen usw. Alles andere wäre doch fahrlässig bei so einer wichtigen Arbeit. Die Dokumentation ist also alles andere als ein Nebenschauplatz. Und mit 10% der Projektzeit (7 von 70 Stunden) ist sie auch völlig ausreichend eingeplant.

   Zuletzt möchte ich noch hinzufügen, dass es manchmal noch nicht einmal nötig ist, die Projektdokumentation innerhalb der Projektzeit und dann auch noch in wenigen Stunden zu schreiben. Jede IHK hat hier nämlich ihre eigenen Regeln und es gibt IHKen, die explizit die Projektdokumentation (nicht die Kunden-/Entwicklerdokumentation) aus der Projektzeit ausschließen. In diesem Fall könnten sich die Prüflinge also so viel Zeit mit der Dokumentation lassen, wie sie wollen. Zu diesem Thema werde ich bei nächster Gelegenheit noch einen Blog-Artikel verfassen, da die Frage immer wieder aufkommt.

   Was sagen Sie denn nun zu meiner Antwort? Ich würde mich über Feedback freuen.

   Viele Grüße! Stefan Macke

5. Michael sagt:

   8. Oktober 2015 um 13:41:35 Uhr

   Hallo Herr Macke,

   ich bin nicht der Kritiker, hatte aber bis vor kurzem ähnliche Bedenken, da ich selbst gerade als Auszubildender FIAE mein Projekt absolviere und entsprechend dokumentiere. Ich habe aber schon seit der Zwischenprüfung eine Vorlage mit Tabellen und „Muster-Verweisen“ in Word (die übrigens an Ihre Vorlage angelehnt ist) und muss im Grunde nur noch schreiben und Quellen suchen. Da ich auch in der deutschen Sprache recht sicher bin und das nicht meine erste Projektdokumentation ist, muss ich in der Regel auch nicht lange überlegen, um üblichen Problemen (Zeitformen, „Ich-Formulierungen“ etc.) aus dem Weg zu gehen. Wenn man dann noch – darüber hatte ich bisher noch gar nicht nachgedacht – berücksichtigt, dass Grafiken und Pläne bereits in den anderen 63 Stunden erstellt werden, scheinen 7 Stunden schon fast viel, haha. Vielleicht wirkt die Dokumentation deshalb auch wie ein Nebenschauplatz: Für sie wird keine so große Mühe mehr aufgewandt, da vieles bereits getan wurde. Sorgfalt muss ja nicht zwingend mit Zeitaufwand verbunden sein. In diesem Sinne: Recht gebe ich Ihnen! Zeitprobleme haben diejenigen, deren Abschlussprojekt gleichzeitig auch das erste ist und die Quellenangabe bisher immer händisch gemacht haben und für die das Inhaltsverzeichnis die höchste Kunst der Verweise gewesen ist.
   Ich habe in meinem Projektantrag für die Projektdokumentation 9 Stunden angegeben (und zwischen Implementierung und Abnahme 3 weitere Stunden für Benutzer- und Entwicklerdokumentation) und wurde von der IHK darauf hingewiesen, die geplante Zeit für die Dokumentation sei recht wenig und ich solle unbedingt darauf achten, innerhalb der 70 Stunden zu bleiben. Die IHK geht also ebenfalls davon aus – wie die meisten Prüflinge – man bräuchte deutlich mehr Zeit als 9 Stunden. An diesem Punkt kommt dann die Kompetenz des Prüflings ins Spiel. Ich selbst werde eventuell wirklich doch eher 11 oder 12 Stunden brauchen, aber ich bin nun auch nicht jemand, der der Beste sein wird, wenngleich ich ebenfalls verkürze und sehr gute Leistungen in der Berufsschule erziele.

   Eine witzige Überlegung am Ende:
   Manche Menschen sehen eine große Leistung, die über ihr eigenes Können weit hinaus geht, und suchen einen Weg, die Leistung in ihr Können zu quetschen.
   Andere sehen diese Leistung und suchen einen Weg, ihr eigenes Können für diese Leistung zu erweitern.

   Mit freundlichen Grüßen

   Michael

6. Peter sagt:

   26. Mai 2021 um 19:38:46 Uhr

   Hallo,
   ich habe mir die Kommentare auf dieser Seite durchgelesen und muss der Kritik absolut zustimmen: Es ist schlicht und ergreifend absurd, zu behaupten, man habe innerhalb von 7 Stunden diese Dokumentation angefertigt! Allein die Vorüberlegungen und Planung dazu benötigen schon zahlreiche Tage. Dann muss der Text entsprechend formuliert werden, wo man sich schnell mal an einem Absatz für eine ganze Stunde verliert. Ich schreibe privat Geschichten und habe durchaus ein Gefühl dafür, wie lange das Formulieren von Texten dauert. Man ist keine Maschine und tippt irgendetwas ununterbrochen runter, sondern liest immer und immer wieder das Geschriebene, korrigiert, passt an oder ergänzt, eh man überhaupt eine neue Seite beginnt.

   Es ist richtig, dass LaTeX sehr vieles abnimmt. Aber allein das Einarbeiten in LaTeX und Anpassen an die eigenen Bedürfnisse ist sehr aufwendig. Selbst wenn man diesen Aufwand dank der fertigen Vorlage und LaTeX-Schulung abmildert, kann mir niemand weismachen, dass der Azubi nicht dennoch Zeit investieren musste, um die vielem Grafiken mit Bildunterschriften einzuarbeiten oder die Quellverweise vorzunehmen. LaTeX übernimmt nur die „formschöne Ausrichtung“ und automatisiert das Erstellen von Inhaltsverzeichnissen und solches; doch dazu muss es erst einmal kommen. LaTeX selbst bietet auch nicht viele Möglichkeiten, sondern wird erst nützlich mit den zahlreichen Paketen, um gewisse Anpassungen an die eigenen Bedürfnisse vorzunehmen. Auch das kostet viel Zeit und Energie. Hier den Leuten eine makellose PDF Datei als 7-h Arbeit zu verkaufen, ist totale Irreführung. Glaubhafter wäre, zu behaupten, diese Dokumentation habe eine ganze Woche Zeit beansprucht.
   (Ich habe selbst schon viel mit LaTeX gearbeitet und längere Fachtexte geschrieben, noch dazu deutlich umfangreichere als diese 15 Seiten. Dennoch schätze ich, dass allein die Dokumentation mich schon die ganze Zeit kosten wird, welche die tolle IHK mir für das Projekt vorgibt. Folglich werde ich genötigt sein, später zu behaupten, die Dokumentation habe nur paar Stunden umfasst, damit noch genug Zeit übrig bleibt, um die eigentliche Realisierung des Projekts zu rechtfertigen. Aber das ist auch typisch Deutschland, wo mehr Wert auf sinnlose Formalien und Bürokratie wert gelegt als die eigentliche Arbeit oder Qualifikation.)

7. Stefan Macke sagt:

   27. Mai 2021 um 9:35:42 Uhr

   Hallo Peter, kurze Antwort: Bei der IHK Oldenburg ist die Projektdokumentation nicht innerhalb der 70 Stunden zu erstellen. Also kann man sich so viel Zeit nehmen wie nötig. Schau gerne auch nochmal hier: Ist die Projektdokumentation Teil der Bearbeitungszeit des IHK-Abschlussprojekts? Und hier: Wie viel Zeit sollte man für die Projektdokumentation einplanen?

    This will be displayed in a monospaced font. The first four 
    spaces will be stripped off, but all other whitespace
    will be preserved.
    
    Markdown is turned off in code blocks:
     [This is not a link](http://example.com)

Here is some inline `code`.