Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- talit:projekte [2026-08-08 14:41] – [Product Requirements Document (PRD)] hof
+++ talit:projekte [2026-08-10 07:22] (aktuell) – [TALIT Programmier-Projekt 2M] hof
@@ Zeile 1: / Zeile 1: @@
 ====== TALIT Programmier-Projekt 2M ======
+<nodisp 2>
+[[https://notebook.google.com/notebook/21e8faae-9e67-4f4b-943e-3a9c139d3a70|Intro Notebook & Slides]]
+</nodisp>
 ===== Übersicht =====
@@ Zeile 40: / Zeile 43: @@
 . Idee ausarbeiten,
 . GitRepo mit passendem Namen erstellen, mit Betreuer teilen
-. **Product Requirements Document** (PRD, mehr Infos unten) *in Repo* erstellen und Betreuer mitteilen (per Teams inkl. Link)
+. Planungsartefakte erstellen als Markdown-Dokumente im Repository:
-. PRD mit Betreuer besprechen (vor Ort oder per Teams)
+. **Product Requirements Document** (PRD, mehr Infos unten)
+. **Design Document** (DD)
+. **Timeline**
+. Planung mit Betreuer besprechen (vor Ort oder per Teams)
 . **Part 4:**
 . Mit arbeiten beginnen
@@ Zeile 49: / Zeile 55: @@
 . Bei Fragen, Problemen in Lektion kommen
-===== Product Requirements Document (PRD) =====
+===== Projektplanung =====
-   * PRD ist kurzes Dokument (1-2 Seiten), welches alles zusammenfasst, was das Produkt (also das Resultat der Arbeit) sein soll.
+Die Projektplanung besteht aus drei Dokumenten, die aufeinander abgestimmt sind und aufeinander verweisen können.
-   * **Format**
-     * Markdown, Datei `prd.md` auf github.
+==== Product Requirements Document ====
+Im _requirements engineering_ werden die aus _Kundensicht_ nötigen Merkmale (_features_) des Produkts ausgearbeitet und im **Product Requirements Document** (PRD, de _Lastenheft_) dokumentiert. Das PRD beantwortet die Frage, **Was & Warum** das Produkt gebaut wird. Es muss vom Auftraggeber (=Lehrperson & Schüler:in) freigegeben werden.
+   * **Umfang**: 1-2 Seiten
+   * **Format**: Markdown, Datei `prd.md` auf github.
    * **Inhalt**
      * **Abstract:** Zu oberst in 2-3 Sätzen das Allerwichtigste kurz zusammengefasst.
@@ Zeile 63: / Zeile 73: @@
        * [[https://wireframe.cc]]
        * [[http://pencil.evolus.vn]] (muss installiert werden)
+   * [[https://github.com/JungleState/ksr_junglestate/blob/main/doc/requirements.md|Beispiel]]
+==== Design Document ====
+Das _Design Doc_ beschreibt, **wie** dass das Produkt gebaut wird.
+   * **Umfang**: 1-2 Seiten
+   * **Format**: Markdown, Datei `design.md` auf github.
+   * **Inhalt**
      * **Technische Details:**
-       * Wie soll umgesetzt werden?
+       * Wie soll das Projekt umgesetzt werden?
        * Welche Programmiersprachen, Frameworks usw. sollen verwendet werden?
        * Hat das Produkt eine Schnittstelle (Web-App, Konsolenprogramm, Programmbibliotheke)?
+       * Was sind die wichtigsten Klassen des Programms (z.B. `Player`, `Enemy`, `Item`)
      * **Herausforderungen**
        * Was sind die grössten 2-3 Herausforderungen oder Stolpersteine?
        * Gibt es bereits Ideen, wie diese angegangen oder umschifft werden könnten?
-     * **Timeline**
+   * [[https://github.com/JungleState/ksr_junglestate/blob/main/doc/visualization.md#technical-design|Beispiel]]
-       * Einteilung der ganzen Umsetzung in 3-4 Milestones (Meilensteine).
-       * Verzichtsplanung: Welche Merkmale sind Must-have, welche Nice-to-have?
-     * [[https://github.com/JungleState/ksr_junglestate/blob/main/doc/requirements.md|Beispiel]]
+==== Timeline ====
+Die _Timeline_ (Zeitplan) beschreibt, **wann** die verschiedenen Teile gebaut werden.
+   * **Format**: Markdown, Datei `timeline.md` auf github.
+   * **Inhalt**
+     * Einteilung der ganzen Umsetzung in 3-4 Milestones (Meilensteine).
+     * Verzichtsplanung: Welche Merkmale sind Must-have, welche Nice-to-have?
+   * Planänderungen, Verzögerungen und Umwege
+     * sind normal!
+     * Die Timeline darf und muss entsprechend angepasst werden.
+     * Das Abgabedatum bleibt hingegen fix -> Verzichtsplanung.
 ===== Kriterien und Anforderungen =====