Skip to content

Commit

Permalink
Merge branch 'unibas-marcelluethi:main' into main
Browse files Browse the repository at this point in the history
  • Loading branch information
Giovvvvva authored Nov 15, 2023
2 parents 8d9bcad + 03e3b3e commit a7e2ff1
Show file tree
Hide file tree
Showing 6 changed files with 13 additions and 11 deletions.
2 changes: 1 addition & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ Einen Überblick über die einzelnen Projektschritte finden Sie auf der [Projekt
|[Woche 9](./week9) | Verifikation / Grundlagen des Testens | Design / Testplan erstellen |
| | Testen im Grossen | |
| [Woche 10](./week10) | Testen im Kleinen | Implementation / Testen |
| [Woche 11](underconstruction) | Softwareprozesse | Implementation / Testen |
| [Woche 11](./week11) | Softwareprozesse | Implementation / Testen |
| | Agile Softwareentwicklung | |
| [Woche 12](underconstruction)| Scrum | Implementation / Testen|
| | Continuous delivery | |
Expand Down
12 changes: 7 additions & 5 deletions docs/project/technical-doc.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,17 +22,19 @@ Die Funktionalität soll in dieser Phase nicht vollständig implementiert werden

#### Technische Dokumentation erstellen

Erstellen Sie die Technische Dokumentation. Nutzen Sie dazu dieses [Template](../project/templates/technical-doc)
Erstellen Sie dann die Technische Dokumentation. Nutzen Sie dazu dieses [Template](../templates/technical-doc)

* [Link zum template im Markdown Format](https://raw.githubusercontent.com/unibas-marcelluethi/software-engineering/main/docs/project/templates/technical-doc.md)

Neben den im Template vorgegebenen Aspekten, muss das Dokument mindestens die folgenden Anforderungen erfüllen:

* Es soll ein UML Klassendiagramm enthalten, welches die Beziehungen zwischen den relevanten Klassen Ihrer Erweiterung und JabRef zeigt.
* Die Dynamik soll für mindestens einen Teilaspekt mithilfe von Sequenz/Kollaborationsdiagrammen, Aktivitätsdiagrammen oder Zustandsdiagrammen spezifiziert werden.
* Können Sie auch OCL-Constraints für einen Aspekt ihrer Erweiterung definieren?
* Es soll ein UML Klassendiagramm enthalten, welches die Beziehungen zwischen den relevanten Klassen Ihrer Erweiterung und JabRef zeigt. Kennzeichnen Sie klar,
welche Klassen bereits in JabRef vorhanden sind und welche Sie neu hinzufügen.
* Erstellen Sie dann ein Sequenzdiagramm, ein Aktivitätsdiagramm und ein Zustandsdiagramm, für jeweils einen Teilaspekt ihres Systems.
* Schreiben Sie einen Abschnitt zur Logik des Systems. Hier sollen die wichtigsten logischen Einschränkungen, die nicht direkt aus den obigen Diagrammen hervorgehen. Sie können dies entweder in
natürlicher Sprache beschreiben oder OCL Constraints definieren.


#### Abgabe:

Die Abgabe erfolgt pro Gruppe, mittels Pull Request auf ihren `project` branch. Den Abgabetermin finden Sie in der [Übersicht](./project-summary). Geben Sie Ihren Betreuer sowie ```marcelluethi``` als Reviewer an.
Die Abgabe erfolgt pro Gruppe, mittels Pull Request auf ihren `project` branch. Den Abgabetermin finden Sie in der [Übersicht](./project-summary). Geben Sie Ihren Betreuer als Reviewer an.
4 changes: 2 additions & 2 deletions docs/project/templates/technical-doc.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Geben sie hier andere relevante Dokumente an, wie z.B. das Pflichtenheft

# 2. Systemübersicht

Hier sollte eine kurze Übersicht über das System gegeben werden.
Hier sollte eine kurze Übersicht über das System gegeben werden.
Das Ziel dieses Abschnitts ist, dass der Leser weiss, was entwickelt wird. Also zum Beispiel sollte man erwähnen,
dass es sich um eine Erweiterung für Jabref handelt, und was das Ziel dieser Erweiterung ist.

Expand Down Expand Up @@ -53,7 +53,7 @@ An dieser Stelle sollten die statischen Aspekte, zum Beispiel mit Hilfe von UML

## 5.2 Dynamik

An dieser Stelle sollten die dynamische Aspekte, zum Beispiel mit Hilfe von UML Sequenz/Kollaborationsdiagrammen, oder Akivitätsdiagrammen beschrieben werden.
An dieser Stelle sollten die dynamische Aspekte, zum Beispiel mit Hilfe von UML Sequenz-, Aktivitäts- oder Zustandsdiagrammen spezifiziert werden.

## 5.3 Logik

Expand Down
2 changes: 1 addition & 1 deletion docs/week11/agile-critic.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ title : Woche 11
# Agile - The good, the bad and the ugly

Im folgenden werden Sie ein Kapitel aus einem Buch zum Thema agile Softwareentwicklung lesen, der sich kritisch mit dem Thema auseinandersetzt.
Das Kapitel stammt aus dem Buch [Agile - The good, the bad and the Ugly](https://www.amazon.com/Agile-Good-Hype-Bertrand-Meyer/dp/3319051547) von Bertrand Meyer. Betrand Meyer war Professor für Software Engineering an der ETH Zürich, und hat sich intensiv mit diesem Thema auseinandergesetzt.
Das Kapitel stammt aus dem Buch [Agile - The good, the bad and the Ugly](https://www.amazon.com/Agile-Good-Hype-Bertrand-Meyer/dp/3319051547) von Bertrand Meyer. Bertrand Meyer war Professor für Software Engineering an der ETH Zürich, und hat sich intensiv mit diesem Thema auseinandergesetzt.

Die Abschnitte 1.1 - 1.5 geben eine (sehr pointierte) Übersicht über die wichtigsten Prinzipien von Agilen Methoden. Die Analyse folgt dann in Abschnitt 1.6.
Ich empfehle Ihnen, das ganze Kapitel zu lesen. Fokussieren Sie sich aber vor allem auf die Analyse in Abschnitt 1.6.
Expand Down
2 changes: 1 addition & 1 deletion docs/week11/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ und geben auch eine Einführung in Agile Softwareentwicklungsmethoden.
* Schritt 1: Softwareprozesse ([Video](https://unibas.cloud.panopto.eu/Panopto/Pages/Viewer.aspx?id=412f9e91-dde8-467a-b3b6-b07c008935ca), [Slides](./slides/Prozesse.pdf))
* Schritt 2: Lesen Sie den Artikel: Agile Softwareentwicklung ([Artikel](./agile))
* Schritt 3: Lesen Sie das Kapitel "Agile - The good the bad and the ugly" ([Artikel](./agile-critic.html))
* Schritt 4: Bearbeiten Sie den Selbsttest für Woche 11 ([auf Adam)](https://adam.unibas.ch/goto_adam_tst_1629490.html)).
* Schritt 4: Bearbeiten Sie den Selbsttest für Woche 11 ([auf Adam)](https://adam.unibas.ch/goto_adam_tst_1646918.html)).

## Übungsstunde

Expand Down
2 changes: 1 addition & 1 deletion docs/week8/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ In der Präsenzveranstaltung werden Sie die Möglichkeit haben, unter Anleitung
## Übungsstunde

Während der Übungsstunde werden sie in Ihren Projektgruppen das Designdokument erstellen und an Ihrem Prototypen weiterarbeiten.
Details finden Sie [in dieser Anleitung](../project/step2/exercises).
Details finden Sie [in dieser Anleitung](../project/technical-doc).

## Hausaufgaben

Expand Down

0 comments on commit a7e2ff1

Please sign in to comment.