Erwartungen an die Dokumentation von Projekten

Autor: Prof. Schneider

Einleitung

Dieser Artikel soll Ihnen bei der Anfertigung von Wiki Artikeln helfen. Im Laufe Ihres Studiums werden Sie einige Projekte durchführen, aber es ist äußerst wichtig auch Ihre Erkenntnisse auch nachhaltig zu dokumentieren, damit andere Ihre Schritte verstehen und diese nachvollziehen können. Dokumentieren Sie fortlaufend während des Projektes im Wiki (Frontloading).

Planung eines Projektes

Im Verlauf des Studiums sollen Sie lernen eigenverantwortlich zu handeln und stukturiert vorzugehen. Hierbei ist es sinnvoll sich an gängigen Prozessmodellen zu orientieren und einen Projektplan aufzustellen.

Prozessmodelle

Nutzen Sie für die Entwicklung ein klassisches Prozessmodell. Wir empfehlen

• V-Modell (für Mechatronikprojekte)
• Kanban (für Mechatronikprojekte)
• SCRUM (für SW-Projekte)

Projektplan

Beginnen Sie frühzeitig (1. Semesterwoche) mit der Projektplanung. Nutzen Sie die Methoden, die Sie im Studium gelernt haben. Ein Gantt-Chart kann helfen Abhängigkeiten (Vorgänger, Nachfolger) zu visualisieren. Planen Sie in Arbeitsstunden und gleichen Sie die Workload mit dem Modulhandbuch ab. Verfolgen Sie den Projektfortschritt. Läuft nicht alles nach Plan, erwähnen Sie dies in Lessons Learned.

Lessons Learned

Nicht immer läuft alles Perfekt. Fassen Sie Ihre wichtigsten Erkenntnisse kurz zusammen und machen Sie diese im nächsten Projekt besser.

Fachlicher Inhalt

Gehen Sie hier systhematisch nach Ihrem Prozessmodell vor:

1. Anforderungsanalyse
2. Systemarchitektur
3. Systementwurf
4. Softwarearchitektur
5. Softwareentwurf
6. Modultests
7. Integrationstests
8. Sytesmtests
9. Abnahmetest
10. Präsentation

Qualität der Dokumentation

Lesen Sie bitte zuerst den Artikel Erwartungen an Präsentation und Dokumentation und befolgen Sie die dort anschaulich beschriebenen Hinweise. Schauen Sie sich auch die Artikel anderer Studierenden an. Sie können sie auch gern die Quelltextseiten ansehen und die Formatierung übernehmen.

Anforderungsanalyse

Erstellen Sie sich ein Lasten-/Pflichtenheft in dem Sie die Anforderungen an Ihr Projektergebniss beschreiben. Geben Sie diesen fortlaufende Nummern (z.B. Req.001).

Hardware (Systemarchitektur, -entwurf)

Beinhaltet Ihr Projekt die Erstellung von Hardware, beachten Sie die nachfolgenden Punkte.

• Hinterlegen Sie Datenblätter für Ihre wichtigsten Bauteile
• Nutzen Sie NI Multisim für die Schaltungsimulation, hinterlegen Sie die Projektdatei und die Simulationsergebnisse.
• Testen Sie Ihren Aufbau auf einem Steckbrett. Dokumentieren Sie das Zwischenergebnis.
• Führen Sie das Leiterplattenlayout mit NI Ultiboard durch, hinterlegen Sie die Projektdatei und das Leiterplattenlayout als Gerber- sowie PDF-Datei.
• Testen Sie die Leiterplatte vor und nach der Bestückung und dokumentieren Sie die Testergebnisse.

Software (Softwarearchitektur, -entwurf)

Beinhaltet Ihr Projekt die Erstellung von Software, beachten Sie die nachfolgenden Punkte.

• Verwenden Sie Header und Kommentare, damit andere Ihren Quelltext verstehen. Beschriften Sie in Simulink beispielsweise die Signalleitungen.
• Ist die Funktion nicht selbsterklärend, nutzen Sie einen Programmablaufplan (PAP) zur Visualisierung der Funktion. Achten Sie darauf, dass das PAP zu Ihrer Implementierung der Software passt.
• Testen Sie Ihre Software anhand der Requirements und dokumentieren Sie Tests und Testergebnisse.

Testing

Testen Sie, ob alle Anforderungen erfüllt sind. Nehmen Sie dabei Bezug auf die Anforderungen (z.B. Req.001). Dokumentieren Sie die Testergebnisse.

Statische Tests:

• Statische Codeanalyse (z.B. mit Polyspace)
• Code Review

Dynamische Tests:

• Modultests
• Integrationstests
• Systemtests
• Abnahmetest

Erlaubte Software-Werkzeuge

Nutzen Sie aus Gründen der Nachhaltigkeit ausschließlich die hier aufgeführte Software.

• Schaltungssimulation: NI Multisim
• Leiterplattenlayout: NI Ultiboard
• Modellbasierte Entwicklung: Matlab/Simulink
• Arduino-Programmierung: Matlab/Simulink
• NXT/EV3 Programmierung: Matlab/Simulink
• CAD: Solid Works
• Statische Codeanalyse: Polyspace
• Dynamische Codeanalyse: Cantata
• Programmablaufpläne: PAP-Designer

Nachhaltiges Arbeiten in SVN

SVN ist die Versionsverwaltung der HSHL. Was Sie dort speichern ist für Ihre Teammitglieder nutzbar und auf dem Server vor Verlust gesichert.

• Nutzen Sie dies und arbeiten Sie nachhaltig in SVN. Spätestens an jedem Arbeitstag sollten Sie die Daten auf dem Server sichern, wenn nicht sogar nach jeder wichtigen Änderung.
• Schreiben Sie zu jedem commit einen sprechenden Log-Kommentar als Erläuterung Ihrer Änderungen.
• Verlinken Sie ihr Repositorium im Wiki Artikel, so dass Ihr Ergebnis auffindbar ist.
• Sichern Sie nur wichtige Dateien in SVN (auf keinen Fall Kompilat oder Backup-Sicherheitskopien).
• Sichern Sie nur getesteten Quellcode in SVN, welcher über Header und Kommentare verfügt.

Hilfestellung

• Sprechen Sie Ihre Vorgehensweise mit Ihrem Betreuer ab.
• Sollten Probleme entstehen, sprechen Sie diese frühzeitig mit dem Beteuer ab. Vielleicht muss ggf. die Aufgabenstellung angepasst werden.