From 5a263b41c36c8cdc3e83f9e4f62245b2432ffc13 Mon Sep 17 00:00:00 2001 From: mlabusch Date: Fri, 30 Jun 2017 14:21:37 +0200 Subject: [PATCH] [Task] Add Documentation --- documentation/microservice_stock/chapter/DokStruktur.tex | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 documentation/microservice_stock/chapter/DokStruktur.tex diff --git a/documentation/microservice_stock/chapter/DokStruktur.tex b/documentation/microservice_stock/chapter/DokStruktur.tex deleted file mode 100644 index d4c899e..0000000 --- a/documentation/microservice_stock/chapter/DokStruktur.tex +++ /dev/null @@ -1,6 +0,0 @@ -\section{Dokumentationsstruktur} -\label{sec: Dokumentationsstruktur} - -Für die Dokumentation des Microservice Warenwirtschaft wurden eine Kombination aus drei Dokumenten gewählt. Zum einen beschreibt ein bebildertes Handout auf einer Seite die Funktionen des Admin-Frontends für dessen Benutzer. Diese sehr kurze Dokumentenform wurde gewählt, da Benutzer häufig nicht gewillt sind umfangreiche Anleitungen zu lesen um eine Anwendung nutzen zu können. Vielmehr wollen sie schnell einen Überblick der Kernfunktionalitäten erhalten. Aus diesem Grund wurde auch auf eine Benutzerdokumentation für die Kunden des Webshops Mosh verzichtet, da anzunehmen ist dass die Darstellung der Produktverfügbarkeit als Ampel sich selbst erklärt.\par -Auf der anderen Seite muss der Microservice auch für die Entwickler dokumentiert sein, hierfür wurde diese Dokumentation angelegt. Sie beginn anstelle eines Abstract mit einem Steckbrief des Microservice, der dessen grundlegende Struktur und Funktionalität kurz beschreibt. Das eigentliche Dokument beschreibt zunächst die Anforderungen an den Microservice, da die Entwicklung sich primär an diesen orientiert. Weiter werden der Microservice mit seinem Aufbau, den Schnittstellen und der Anpassung des gegebenen Monolithen sowie Implementierungsregeln beschrieben. Dieses Dokument schließt mit einem \textit{Getting Started} Guide. Auf Details wir ein Abkürzungs- oder Literaturverzeichnis wurde in dieser Dokumention bewusst verzichtet, um sie kurz zu halten. Zitate und Verweise werden hier in Form von Fußnoten integriert.\par -Abschließend dokumentiert das Testprotokoll -- als drittes Dokument -- die für diesen Microservice angewendeten Black-Box-Testfälle. Das heißt es umfasst solche Tests die anhand der Anforderungen und aus Sicht des Benutzers durchgeführt wurden. \ No newline at end of file