Erwartungen an die Dokumentation von Projekten: Unterschied zwischen den Versionen

Version vom 13. März 2018, 16:35 Uhr

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.

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

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).

Planung und Durchführung

Software

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.

Hardware

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.

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:

Modultest
Systemtest
Abnahmetest

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.

@@ Zeile 3: / Zeile 3: @@
 == 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.
+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 ==
@@ Zeile 9: / Zeile 9: @@
 === Prozessmodelle ===
+Nutzen Sie für die Entwicklung ein klassisches Prozessmodell. Wir empfehlen
+* [https://de.wikipedia.org/wiki/V-Modell V-Modell] (für Mechatronikprojekte)
+* [https://www.heise.de/developer/artikel/Software-Kanban-im-Einsatz-1235465.html?seite=all Kanban] (für Mechatronikprojekte)
+* [https://www.heise.de/developer/artikel/Kriterien-fuer-eine-Entscheidung-fuer-Scrum-oder-Kanban-1071172.html?seite=all 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.
 === 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 ==
@@ Zeile 18: / Zeile 24: @@
 == Qualität der Dokumentation ==
 Lesen Sie bitte zuerst den Artikel [[Erwartungen_an_Pr%C3%A4sentation_und_Dokumentation|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).
+=== Planung und Durchführung ===
 === Software ===
@@ Zeile 24: / Zeile 35: @@
 * 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.
+=== Hardware ===
+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.
+=== 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:
+* Modultest
+* Systemtest
+* Abnahmetest
 == Nachhaltiges Arbeiten in SVN ==
@@ Zeile 32: / Zeile 63: @@
 * 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.