Changes for page Anforderungen Software
Last modified by mgrawunder on 2025/09/29 10:00
From 2.1 to 2.2
From 5.1 to 6.1
From version 2.2
edited by Pascal Meyer
on 2025/07/30 18:37
on 2025/07/30 18:37
Change comment:
Update document after refactoring.
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. PascalMeyer1 +XWiki.pmeyer - Content
-
... ... @@ -1,3 +1,5 @@ 1 +[[image:Main.Organisatorisches.WebHome@softwareprojekt_logo_transparent.png||alt="SoftwareprojektLogo.png" data-xwiki-image-style-alignment="end" height="136" width="309"]] 2 + 1 1 {{toc/}} 2 2 3 3 = Anforderungen: Spielumsetzung = ... ... @@ -45,7 +45,7 @@ 45 45 Um gut in das SWP zu starten, gibt es drei **vordefinierte** Meilensteine. 46 46 47 47 * Der erste Meilenstein ist durch die gemeinsame Bearbeitung der Übungsaufgaben erreicht. 48 -* Für den zweiten Meilenstein (s.u.) gibt es eine [[ Präsentation>>url:https://confluence.swl.informatik.uni-oldenburg.de/spaces/SWP/pages/393401/TA+5+Zwischenpr%C3%A4sentation]]. Das ist die erste Präsentation bei mir.50 +* Für den zweiten Meilenstein (s.u.) gibt es eine [[Zwischenpräsentation>>doc:Main.Aufgabenstellung.WebHome||anchor="HTeilaufgabe5:ZwischenprE4sentation"]]. Das ist die erste Präsentation bei mir. 49 49 * Es gibt eine Präsentation für den Prototypen (Meilenstein X), im zweiten Semester. 50 50 * Es gibt eine Präsentation für das finale Produkt (Endabnahme) zum Ende des zweiten Semesters. 51 51 ... ... @@ -97,13 +97,13 @@ 97 97 98 98 = Anforderungen: Dokumentation = 99 99 100 -Im Softwareprojekt muss am Ende zusätzlich zum eigentlichen Produkt ein Dokument (das kann auch durch einen Export aus Confluence erfolgen) abgegeben werden, welches im Wesentlichen die folgenden Aspekte enthalten sollte:102 +Im Softwareprojekt muss am Ende zusätzlich zum eigentlichen Produkt ein Dokument abgegeben werden, welches im Wesentlichen die folgenden Aspekte enthalten sollte: 101 101 102 102 * Eine allgemeine Einleitung für das Dokument. Worum geht es und wie ist das Dokument aufgebaut. 103 103 * Grundsätzlich sollte jeder Abschnitt kurz eingeleitet werden und jeden Kapitel sollte eine kurze Zusammenfassung bekommen. 104 104 * Quellen müssen angebenen werden, also z.B. nicht einfach Text von einer Web-Seite kopieren. Das kann u.U. als Plagiat ausgelegt werden... 105 105 * Eine Darstellung der ermittelten Anforderungen. 106 -** Dies umfasst mindestens die umgesetzten User-Stories (Sinnvoll: Die Akzeptanzkriterien für eine User-Story mit angeben.). Idealerweise werden die UserStories noch durch Anwendungsfälle unterstützt. 108 +** Dies umfasst mindestens die umgesetzten User-Stories (Sinnvoll: Die Akzeptanzkriterien für eine User-Story mit angeben.). Idealerweise werden die UserStories (siehe [[User-Stories>>doc:Main.Scrum.WebHome||anchor="HUserStories"]]) noch durch Anwendungsfälle unterstützt. 107 107 ** Ggf. eine Darstellung/Auflistung nicht umgesetzter User Stories. Die kann noch einmal zeigen, welche kreativen Ideen zeitlich nicht mehr umgesetzt wurden 108 108 ** Die Stories sollten möglichst gruppiert (z.B. nach Nutzerverwaltung, Hauptmenue/Lobby, etc.) werden. 109 109 * Darstellung der Realisierung ... ... @@ -151,7 +151,7 @@ 151 151 ** Ggf. vollständige Klassendiagramme (Ohne weitere Erläuterung) 152 152 ** Protokolle und andere im Laufe der Zeit entstandene Dokumente in speziellen Ordner hinterlegen. **Nicht (mehr) in das Dokument mit aufnehmen**, das ist nur unnötige Arbeit. 153 153 * Glossar mit Begriffen des Gegenstandes/Spiels 154 -* Index (Falls Dokument mit LaTeX erstellt , bei Confluence-Export nicht möglich/notwendig)156 +* Index (Falls Dokument mit LaTeX erstellt) 155 155 156 156 Ich werde immer wieder gefragt, wieviele Seiten die Dokumentation haben muss. Das lässt sich so pauschal leider nicht sagen, denn das hängt zum einen natürlich massiv von der verwendeten Vorlage ab, zum anderen aber auch davon, welches die aktuelle Aufgaben gewesen ist. Zur Orientierung kann man jedoch sagen, dass die typische (gelungene) (LaTeX-basierte-)Dokumentation in den letzten Jahren immer so in dem Bereich von 80 bis 100 Seiten (inkl. Anhängen und Bildern) gelegen hat. Es macht nun aber keinen Sinn, die Seitenanzahl künstlich durch "unnötigen" Inhalt aufzublähen. Ich schaue schon sehr genau darauf, wie gelungen und vollständig die oben genannten Punkte abgehandelt werden. 157 157 ... ... @@ -167,7 +167,7 @@ 167 167 168 168 * Falls es Widersprüche zwischen der Vorlage und dem Text hier im Wiki gibt, bitte eine kurze Nachricht. Im Zweifelsfall zählt der Inhalt aus dem Wiki. 169 169 * Falls etwas nicht korrekt funktioniert, bitte auch eine kurze Nachricht. Ich kümmere mich. 170 -* Gruppen, die ihre Dokumentation auch im git pflegen wollen, können mir einen Nachricht schicken und ich richte das Repo dann passend ein.172 +* Gruppen, die ihre Dokumentation auch im Git pflegen wollen, können mir einen Nachricht schicken und ich richte das Repo dann passend ein. 171 171 * [[https:~~/~~/git.swl.informatik.uni-oldenburg.de/projects/SPB/repos/dokumentation/browse/>>url:https://git.swl.informatik.uni-oldenburg.de/projects/SPB/repos/dokumentation/browse/]] 172 172 {{/success}} 173 173