Die 17 häufigsten Fehler in der Projektdokumentation – Anwendungsentwickler-Podcast #9

In der neunten Episode meines Anwendungsentwickler-Podcasts gebe ich Beispiele für die 17 häufigsten Fehler in der Projektdokumentation und zeige wie man sie vermeiden kann.

Probeabo bei Audible (Affiliate)

Inhalt

  • Formelle Fehler (leicht/schnell zu korrigieren)
    1. Es sind Rechtschreib-, Interpunktions- und Grammatikfehler vorhanden.
      • Lasst eure Dokumentation von jemandem (am besten von mehreren Personen) korrekturlesen!
    2. Es sind Rechenfehler vorhanden.
      • Kontrolliert unbedingt sämtliche Berechnungen (insb. Kosten, Amortisation) auf Fehler.
    3. Es sind keine Quellenangaben vorhanden.
      • Was ihr euch nicht selbst ausgedacht habt, muss mit Quellen versehen werden.
    4. Die mögliche Seitenzahl wird nicht komplett ausgenutzt.
      • Nutzt alle erlaubten Seiten bis aufs Letzte aus. Es wäre ärgerlich, wenn ihr eine schlechte Note bekommt, obwohl ihr noch mehr Inhalte hättet zeigen können.
    5. Seiten werden mit uninteressanten Inhalten aufgefüllt.
      • Packt nur interessante Inhalte (z.B. Quelltexte, Screenshots, Dokumentation) in die Dokumentation und nicht seitenweise langweilige Inhalte.
    6. Verweise auf Artefakte fehlen.
      • Alle Artefakte (Bilder, Tabellen, Code usw.) müssen im Text referenziert werden.
    7. Fehler in der Nutzwertanalyse.
      • Achtet auf die formelle Korrektheit der Nutzwertanalyse. Erläutert die Kriterien, die Bewertungsskale und die konkrete Bewertung.
  • Fachliche Fehler (schwierig/aufwändig zu korrigieren)
    1. Der Wirtschaftlichkeitsteil fehlt.
      • Eine wirtschaftliche Betrachtung des Projekts ist Pflicht!
    2. Der Technikteil fehlt.
      • Die Technik sollte den Großteil der Dokumentation füllen.
    3. Die Dokumentation fehlt.
      • Benutzer- und Entwicklerdokumentation sind absolutes Pflichtprogramm in der Projektdokumentation.
    4. Es sind keine Quelltextbeispiele vorhanden.
      • Prüfer wollen euren (interessanten!) Quelltext sehen.
    5. Es sind nur langweilige Quelltextbeispiele vorhanden.
      • Bitte keine Getter/Setter und Klassendefinitionen, sondern spannende Algorithmen zeigen.
    6. Getroffenen Entscheidungen werden nicht begründet.
      • Insb. die zentralen Entscheidungen (Programmiersprache, Entwicklungsprozess, Datenbank usw.) müssen nachvollziehbar begründet werden.
    7. Es ist kein methodisches Vorgehen erkennbar.
      • Wir programmieren nicht einfach drauflos, sondern folgen einem definierten Plan und wenden etablierte Methoden (z.B. UML, ERM) an.
    8. Triviale Inhalte werden detailliert ausgeführt.
      • Bitte nicht eine einfache Berechnung auf drei Seiten bis ins letzte Detail auseinandernehmen, sondern auf einer abstrakteren Ebene euer Projekt und dessen Komponenten schildern.
    9. Das Ziel des Projekts wird nicht deutlich.
      • Was hat der Prüfling eigentlich selbst gemacht? Warum ist das sinnvoll?
    10. Die notwendige technische Tiefe wird nicht erreicht.
      • Ist der Umfang des Projekts für ein Abschlussprojekt nach drei Jahren Ausbildung angemessen oder wird nur eine triviale Aufgabe gelöst?

Meine Vorlage für die Projektdokumentation könnt ihr als Grundlage für eure Dokumentation oder als Vergleichsdokument verwenden, um eure Dokumentation auf die obigen Fehler zu prüfen.

Vorlage für die Projektdokumentation

Literaturempfehlungen

  • Anselm Rohrer - Clevere Tipps für die Projektarbeit – IT-Berufe: Abschlussprüfung Teil A (Affiliate)*
  • Felicia Ullrich - Ratgeber für die mündliche Prüfung. 10 clevere Tips für die mündliche Prüfung (Affiliate)*

Links

Weitere Infos zur Projektdokumentation

Du suchst noch mehr Tipps rund um die Projektdokumentation? Dann schau doch mal in diese Artikel- und Podcast-Kategorie: Alle Artikel rund um die Projektdokumentation.

Kennst du schon meine Microsoft Word-/LibreOffice-Vorlage für die Projektdokumentation? Unter dieperfekteprojektdokumentation.de kannst du sie herunterladen.

Und wenn du dich für meinen Newsletter einträgst, kannst du dir jetzt sofort meine Checkliste für die Projektdokumentation herunterladen.

Checkliste für die Projektdokumentation

Jetzt anmelden!

Polyglot Clean Code Developer
About the Author
Ausbildungsleiter für Fachinformatiker Anwendungsentwicklung und Systemintegration, IHK-Prüfer und Hochschuldozent für Programmierung und Software-Engineering.

3 comments on “Die 17 häufigsten Fehler in der Projektdokumentation – Anwendungsentwickler-Podcast #9

  1. Jonas sagt:

    hilfreich und interessant, wie immer 🙂

  2. Christian sagt:

    Es ist sehr ironisch, dass unter Punkt 1 des Inhalts, „Es Rechtschreib-, Interpunktions- und Grammatikfehler vorhanden.“, ein Wort fehlt

  3. Stefan Macke sagt:

    Danke für diesen unironischen Hinweis. Ist korrigiert. 😛

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

To create code blocks or other preformatted text, indent by four spaces:

    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)

To create not a block, but an inline code span, use backticks:

Here is some inline `code`.

For more help see http://daringfireball.net/projects/markdown/syntax