feat: jochen feedback

chapters/einleitung.tex

@@ -7,7 +7,7 @@ Excel-Tabelle übertragen werden, ab.
 
 \section{Problemstellung}
 \label{chap:einleitung-problemstellung}
-Die Teilnehmenden Weingüter schicken ihre Weine zusammen mit Formularen über den Postweg zu \ac{WM}.
+Die teilnehmenden Weingüter schicken ihre Weine zusammen mit Formularen über den Postweg zu \ac{WM}.
 Es ist der Normalfall, dass ein teilnehmendes Weingut \emph{mehrere} Weine zur Bewertung anbringt.
 In diesem Fall ist für jeden anzumeldenden Wein ein solches Formular erneut auszufüllen.
 Hierbei werden sämtliche auf das Weingut bezogene Daten redundant ausgefüllt. Diese Daten sind redudant, da sie keine
@@ -15,8 +15,8 @@ Eigenschaften der Weine, sondern die des Weingutes selbst sind.
 Da sich das Weingut zwischen den Weinen nicht ändert,
 ändern sich die darauf bezogenen Daten auch nicht. Sie müssen aber für jeden Wein erneut ausgefüllt werden.
 Abgesehen davon, dass solche Redundanzen auf Weinguts- und Verbandsseite die hedonische Qualität schädigen,
-bietet so ein Workflow Freiraum für Fehler und Inkonsistenzen.
-Dieser Workflow, mit den zuvor genannten Nachteilen, wird auf Verbandsseiten, nach Zustellung der Weine, weiter fortgeführt:
+bietet ein solcher Workflow Freiraum für Fehler und Inkonsistenzen.
+Dieser Workflow, mit den zuvor genannten Nachteilen, wird auf Verbandsseite, nach Zustellung der Weine, weiter fortgeführt:
 \ac{WM} erfährt erstmalig mit der Zustellung eines Weines von dessen Teilnahme. Das erschwert die Planung der Logistik,
 da im Voraus keine konkrete Zahl der zu erwartenden Flaschen bekannt ist. Geht eine Flasche auf dem Postweg verloren,
 könnte das unbemerkt bleiben, da der Prozess für das Weingut mit dem Versand endet und der Prozess für \ac{WM}
@@ -43,9 +43,9 @@ Während die Constraints bereits bekannt sind, werden detaillierte Anforderungen
 im Rahmen der Anforderungstechnik ausgearbeitet \cite{bib:heinemann-vorlesung-re}.
 Die Constraints besagen, dass der Anmeldeprozess in die existierende Internetpräsenz des Weinverbandes integriert werden muss.
 Bei dieser Internetpräsenz handelt es sich um ein TYPO3-Redaktionssystem.
-Sämtliche Interaktionen zwischen Akteuren, die nicht \ac{WM} oder dem System zugehörig sind,
-müssen im Frontend der Webseite stattfinden. Oberflächen für Mitarbeiter von \ac{WM} dürfen
-in der TYPO3-Backend-Oberfläche implementiert werden.
+Sämtliche Interaktionen zwischen Akteuren, die nicht \ac{WM} oder dem Softwaresystem zugehörig sind,
+müssen im Frontend der Webseite stattfinden, da das Backend den Redakteuren und Administratoren vorbehalten ist.
+Oberflächen für Mitarbeiter von \ac{WM} dürfen in der TYPO3-Backend-Oberfläche implementiert werden.
 \\
 \\
 Somit lautet die \textbf{Forschungsfrage}:\\

chapters/stand-der-forschung.tex

@@ -46,7 +46,7 @@ Positionierung des Unternehmens im Hinblick auf den Zielzustand mit Fokus auf di
 der Ist-Zustand im Kontext des Soll-Zustandes anhand definierter Fragen bewertet. Die Auswahl der Fragen unterscheidet sich je
 nach Art der Ziele. Der gesamte Fragenkatalog kann im Detail der Ausarbeitung von Parviainen et al. entnommen werden.
 
-\paragraph*{Der dritter Schritt} ist die Festlegung der konkreten Schritte, die für den Übergang vom
+\paragraph*{Im dritten Schritt} werden konkrete Schritte festgelegt, die für den Übergang vom
 Ist-Zustand zum Soll-Zustand erforderlich sind. Dazu muss zunächst die Lücke zwischen dem Ist- und dem Soll-Zustand
 identifiziert werden. Relevant ist dabei der aktuelle Stand der Technik und welche Veränderungen notwendig sind, um den
 Zielzustand zu erreichen. Anschließend sollten die konkreten Schritte identifiziert werden, die erforderlich sind, um diese

chapters/stand-der-technik.tex

@@ -19,7 +19,7 @@ um hochindividualisierte Funktionalitäten zu ermöglichen.
 \section{QR-Code-Bibliotheken}
 Um mit QR-Codes zu arbeiten, ist es unabdinglich, QR-Codes zu erstellen, da dieselben sonst nicht vorhanden sind.
 Im Folgenden werden einige Implementationen von QR-Code-Generator-Bibliotheken im Detail betrachtet. Es wird sich
-auf bereits verwendete Programmiersprachen begrenzt.
+auf bereits vom System verwendete Programmiersprachen begrenzt.
 
 \subsection{Javascript-Implementationen}
 \subsubsection*{Jquery-qrcode}
@@ -42,7 +42,7 @@ Issues scheinen ignoriert zu werden. Kjua ist MIT-lizensiert \cite{bib:larsjung-
 
 \subsubsection*{Soldair/node-qrcode}
 \textit{Soldair/node-qrcode} ist eine node.js-basierte Implementation eines QR-Code-Generators und bietet somit Funktionialität
-serverseitig, als CLI, sowohl auch Browserseitig an. Die Readme-Datei zeugt von Länge, ist reich an Beispielen
+serverseitig, als Kommandozeilenwerkzeug, sowohl auch Browserseitig an. Die Readme-Datei ist umfangreich, reich an Beispielen
 und detailreichen Erklärungen. Der letzte Commit ist zu diesem Zeitpunkt knapp älter als ein halbes Jahr. Somit macht das
 Projekt einen moderat gepflegten Eindruck. Die Readme-Datei verweist auf Unit Tests bei Travis, jedoch lief die letzte Pipeline
 vor circa zwei Jahren, Februar 2021, durch und schlug fehl. Einige Pull-Requests und Issues werden seit Jahren ignoriert
@@ -89,8 +89,9 @@ von vor zehn Jahren. BaconQrCode stellt das beliebteste und gepflegteste Projekt
 einem aktuellsten Commit von vor zwei Monaten dar. BaconQrCode fällt mit siebzehn Entwicklern auf, die jeweils zumindest
 einen Commit beigetragen haben. Zu diesem Zeitpunkt fanden 177 Commits statt. Githubs DependencyGraph verzeichnet
 nahezu 80.000 Projekte, die BaconQrCode verwenden \cite{bib:bacon-baconqrcode} und Packagist meldet 50 Millionen Downloads
+\cite{bib:packagist-baconqrcode}.
 Wie \textit{chillerlan/php-qrcode} baut auch Scholzen auf existierende Technik von \enquote{ZXing} auf.
-\cite{bib:packagist-baconqrcode}. Eine Dokumentation neben der Readme-Datei existiert nicht und
+Eine Dokumentation neben der Readme-Datei existiert nicht und
 diese ist sehr minimalistisch. \textit{BaconQrCode} kann QR-Codes als Rasterbilder und Vektorgrafiken (SVG und EPS) generieren.
 Spezielle Styles sind nicht erwähnt. Ein Großteil der Issues und Pull-Requests wurden behandelt.
 BaconQrCode unterliegt einer BSD-2-Clause-Lizenz
@@ -118,12 +119,13 @@ Hierfür werden die zuvor vorgestellten Bibliotheken zur Erstellung von QR-Codes
 
     \item [Workflow-Eignung] \hfill \\
         Die Eignung einer Bibliothek in existierende Workflows und Constraints übernommen zu werden. Maßgeblich,
-        ob und mit wie viel Aufwand eine Bibliothek in das Projekt übernommen werden kann. Ebenfalls ist relevant,
-        ob die Lizenz einer Bibliothek eine Verwendung gestattet, bzw. welche Bedingungen gelten.
+        ob und mit wie viel Aufwand eine Bibliothek in das Projekt übernommen werden kann.
+        Beispielsweise ist es deutlich aufwänder eine JavaScript-Bibliothek in einem PHP-Projekt zu verwenden, als eine native PHP-Bibliothek.
+        Ebenfalls ist relevant, ob die Lizenz einer Bibliothek eine Verwendung gestattet, bzw. welche Bedingungen gelten.
 \end{description}
 
 Hierbei werden den verschiedenen Bibliotheken Punkte ($[0,10]$) in den drei zuvor genannten
-Kategorien vergeben. Nicht ermittelte Werte werden in ihrer Kategorie durch $-$ repräsentiert, wodurch
+Kategorien vergeben. Nicht ermittelte Werte werden in ihrer Kategorie durch \enquote{$-$} repräsentiert, wodurch
 eine weitere Verwendung ausgeschlossen wird.
 Die Kumulativpunktzahl ($[0,30]$) einer Bibltiothek beschreibt deren Gesamteignung, nach subjektivem
 Empfinden des Autors.
@@ -200,7 +202,7 @@ bereitgestellt \cite{bib:chillerlan-php-qrcode-composerjson} und weist eine ähn
 \subsubsection*{Kreativekorp/barcode}
 Kreativekorp beeindruckt durch Nutzungsbeispiele und Dokumentation in der Readme-Datei,
 sowie einer Vielzahl unterstützter Barcode-Formate, darunter auch QR-Codes und einiger improvisierter Tests.
-In Anbetracht dessen, dass die Bibliothe de-facto sechseinhalb Jahre alt ist und seit vier Jahren nicht mehr
+In Anbetracht dessen, dass die Bibliothek de-facto sechseinhalb Jahre alt ist und seit vier Jahren nicht mehr
 angepasst wurde, wird eine geringe Wertung von drei Punkten in \enquote{Gepflegtheit} vergeben.
 Null Punkte in \enquote{Workflow-Eignung} rechtfertigen sich durch die Abwesenheit jeglicher
 Unterstützung für Paketmanager, wodurch eine saubere Verwendung in dem Brown-Field-Projekt
@@ -274,5 +276,5 @@ Wartbarkeit und Nachhaltigkeit des hier behandelten Softwareproduktes
 zu fördern, wird sich für den PDF-Generator entschieden, der bereits firmeninterner Standard ist.
 Unabhängig dessen ist \textit{mpdf} ein gut gepflegtes Projekt mit einem Alter von mehr als acht Jahren,
 Sponsoren, 72 Entwicklern, über 31 Millionen Downloads, über 3.900 Sterne-Markierungen, über 800 Commits
-und regelmäßigen Updates. Dadurch, dass \textit{mpdf} ein Composer-Paket für verschiede PHP-Versionen ist,
+und regelmäßigen Updates \cite{bib:mpdf-github}. Dadurch, dass \textit{mpdf} ein Composer-Paket für verschiede PHP-Versionen ist,
 ist eine herausragende Workflow-Eignung gegeben \cite{bib:mpdf}.