Vorlage Projektstruktur & OpenUP-Templates

Das Repository enthält die Vorlage einer Projektstruktur und Template-Dokumente im AsciiDoc-Format. Dies wird für die Bearbeitung der Belegarbeit in Software Engineering I und II benötigt. Im Detail wären dies:

Projektstruktur anhand der Work Products im OpenUP
Templates der benötigten OpenUP-Dokumente (AsciiDoc-Format)
Vorlage für die Belegabgabe in SE I (AsciiDoc-Format)

Hinweis: Dieses Repository enthält keinen Code.

Inhaltsverzeichnis

Projektstruktur
Unified Process - Templates
Hinweise zu AsciiDoc
Belegabgabe in SE I
Lizenz

Projektstruktur

Die Projektstruktur im Verzeichnis docs orientiert sich an den Work Products im OpenUP und den für die Abgabe im SE 1 Beleg geforderten Dokumenten.

docs
├── architecture
│   └── architecture_notebook.adoc
├── deployment
├── development
│   └── design.adoc
├── environment
├── project_management
│   ├── iteration_plan_01.adoc
│   ├── project_plan.adoc
│   ├── risk_list.adoc
│   └── risks.csv
├── requirements
│   ├── domain_model.adoc
│   ├── glossary.adoc
│   ├── system-wide_requirements.adoc
│   ├── use-case_model.adoc
│   ├── use_case_01.inc.adoc
│   └── vision.adoc
└── test
    └── test_cases.adoc

Unified Process - Templates

Dieses Repositority enthält Vorlagen im AsciiDoc-Format für die Arbeit mit dem Open Unified Process. Die Vorlagen basieren auf den Templates der offiziellen OpenUP Dokumentation in der Version 1.5x aus dem Eclipse Process Framework (EPF) und wurden bis auf geringe inhaltliche / strukturelle Anpassungen lediglich auf deutsch übersetzt.

Hinweise

Im Unified Process gibt es eine "Supplementary Specification", die Anforderungen enthält, die nicht als Use Case Model spezifiziert werden können. Das sind z.B. nicht-funktionale und systemweite Anforderungen. Im OpenUP (und in diesem Repository) heißt dieses Dokument "System-wide Requirements".
Falls Sie Fehler korrigieren oder Verbesserungen machen möchten, können Sie dies gern über einen Pull Request tun.

Referenzen

Hinweise zu AsciiDoc

Die Datei default-attributes.inc.adoc im docs/_includes Verzeichnis enthält die gemeinsamen Dokumentenattribute für alle AsciiDoc-Dokumente. In jedem Dokument selbst können, nach dem include der Datei, entsprechend noch extra benötigte Attribute mit aufgenommen werden.

Projektnamen definieren

In der default-attributes.inc.adoc Datei ist am Anfang der Projektname definiert, welcher in jedem Dokument im Title verwendet wird. Ersetzen Sie hier bitte <Projektname (T00)> mit Ihrem Belegthema:

// Meta
:project-name: <Projektname (T00)>

T ... steht als Platzhalter für I ein internes bzw. E für ein externes Projektthema

Bilder und Diagramme einbinden

In dem Dokumentenattribut :imagesdir: images ist das Standardverzeichnis images für die Bilder festgelegt. Somit reicht es, in den jeweiligen Dokumenten, die Bilder ohne Angabe des images Verzeichnis einzubinden:

// vision.adoc
image::example.jpg[Beispielbild]

In dem Dokumentenattribut :plantumlsdir: plantuml ist das Standardverzeichnis plantuml für die Diagramme in plantUML-Notation festgelegt. Im Dokumentenattribut :diagramsdir: diagrams ist das Verzeichnis für die generierten Diagramme angegegben, welches unter dem :imagesdir: angelegt wird.

requirements
├── images
│   ├── diagrams
│   │   └── diagram.jpg
│   └── example.jpg
├── plantuml
│   └── diagram.puml
├── ...
└── vision.adoc

Belegabgabe in SE I

Im Verzeichnis belegabgabe_se1 finden Sie die Vorlagedatei se1_belegabgabe_t00.adoc, welche alle Ihre erzeugten Dokumente für die Abgabe als PDF in ein Dokument bündelt.

(Nutzen Sie nicht die Projektvorlage Projektstruktur_OpenUP-Templates, kopieren sie sich die Vorlagedatei se1_belegabgabe_t00.adoc in Ihr Projektrepository)

Folgende Schritte sind für eine Belegabgabe durchzuführen:

Ändern Sie die Themennummer t00 in der Vorlagedatei se1_belegabgabe_t00.adoc in Ihre Themennummer (i01, i02, ..., e01, e02, ...).
Inhalt der Vorlagedatei anpassen:
- Ist in Ihrem Projekt in der Datei docs/_includes/default-attributes.inc.adoc der Projektname im Attribut :project-name: nicht gesetzt bzw. nutzen Sie eine andere Struktur, können Sie im Dokumententitel nach dem : das {project-name} mit Ihrem Projektthema ersetzen:
```
// --- 1. Projektthema -------------------------
= SE I - Belegabgabe: {project-name}
```
- Tragen Sie alle Teammitglieder als Autoren ein:
```
// --- 2. Teammitglieder -----------------------
Vorname Nachname <s00000@htw-dresden.de>; Vorname Nachname <s00000@htw-dresden.de>; ...
```
  Lange Autorennamen (mehr als 3 Teile) in den Dokumentenattributen müssen mit einem _ (Unterstrich) zu einer Gruppe von Vor- bzw. Nachnamen zusammengefasst werden. Es treten sonst Formatierungsfehler beim erzeugen der HTML- oder PDF-Dokumente auf. Der _ (Unterstrich) wird im erzeugten Dokument nicht dargestellt.
  - Vorname1_Vorname2 Nachname1_Nachname2 <mail@example.com>
  - Vorname Nachname1_Nachname2_Nachname3 <mail@example.com>
- Tragen Sie als Versionsdatum Ihr Abgabedatum ein:
```
// --- 3. Abgabedatum --------------------------
01. Januar 2020
```
- Passen Sie bei abweichender Projektstruktur die include-Pfade und Dateinamen zu den einzelnen Dateien (path/to/file.adoc) an bzw. erweitern Sie es für zusätzliche Dokumente:
```
include::path/to/file.adoc[lines=1..1;4..-1,leveloffset=+1]
```
  Beim include wird über die lines=1..1;4..-1 Angabe jeweils die 1. und alles ab der 4. Zeile übernommen. Jedes Dokument ist eigenständig und somit werden über die Zeilen 2 und 3 die jeweiligen Authoren und das Versionsdatum nicht mit übernommen.

Erzeugen Sie das Abgabe-PDF _se1_belegabgabe_t00.pdf_ (Hinweise aus dem Praktikum):

$ asciidoctor-pdf se1_belegabgabe_t00.adoc

oder:

$ asciidoctor -r asciidoctor-pdf -b pdf se1_belegabgabe_t00.adoc

Prüfen Sie, dass das korrekte Projektthema, alle Teammitglieder und das Abgabedatum auf dem Deckblatt stehen und dass ebefalls alle erforderlichen Dokumente mit ihren Inhalten enthalten sind.
Geben Sie das finale Abgabe-PDF _se1_belegabgabe_t00.pdf_ über den mitgeteilten Weg ab.

Lizenz

Dokumentation

Die OpenUP Templates im Ordner docs und belegabgabe_se1 unterliegen der CC-BY-4.0 Lizenz.

Quellcode / Anderes

Für das Repository bzw. die entstehende Software kann/muss eine separate Lizenz festgelegt werden.

Dirkforthree / project04private

readme