Ich schreibe meine Bachelorarbeit im Bereich Software Engineering. Es ist in zwei Teile gegliedert: einen theoretischen Teil, in dem ich vorhandene Literatur analysiere, Modelle vergleiche und Schlussfolgerungen ziehe; und einen Teil, in dem ich meine Softwarelösung für ein Problem unter Verwendung der im theoretischen Teil definierten Muster präsentiere.
Ein Kapitel im theoretischen Teil handelt von einem Prozess namens Domain Driven Design, bei dem es natürlich ist, Codebeispiele einzufügen, da sie das Verständnis der Konzepte erleichtern. Meine Codebeispiele sind nicht mit der von mir erstellten Software verbunden.
Soll ich Codebeispiele, die nicht direkt mit meiner App zusammenhängen, in den theoretischen Teil einer Abschlussarbeit stellen? Oder reicht es, wenn ich nur Begriffe ohne Beispiele definiere? (im zweiten Teil werden sie sowieso während der Analyse meiner App referenziert)
Theoretische Konzepte sind ohne Beispiele immer schwer zu verstehen. Außerdem können die Beispiele Beweise für die Solidität der Konzepte liefern und im Allgemeinen das Vertrauen des Lesers sowohl in sein Verständnis der Konzepte als auch in die Solidität der Konzepte selbst stärken.
Also ja, es ist eine gute Idee, Beispiele in Ihr konzeptionelles Material aufzunehmen. Wenn das Konzept, das Sie erklären, komplex oder unbekannt ist, ist es auch gut, es in Schichten mit Beispielen für jede Schicht aufzubauen, während Sie es einführen. Ein Beispiel, das Stück für Stück aus einfacheren Teilen aufgebaut ist, ist in der Regel leichter zu verstehen als eines, das in seiner ganzen Komplexität als Ganzes dargestellt wird. Es ist sehr leicht, die Klarheit von Konzepten, mit denen wir vertraut sind, zu überschätzen, also ist es eine gute Sache, es in Stücke zu zerlegen und jedes Stück zu erklären und zu illustrieren, auch wenn es Ihnen unnötig langsam erscheint.
Überlegen Sie abschließend, ob es nicht besser wäre, Ihre Beispiele in Pseudocode statt in echtem Code zu zeigen. Dies vermeidet nicht nur Probleme mit einigen Lesern, die mit der Sprache des Codes nicht vertraut sind, sondern es kann auch Pseudocode geschrieben werden, um das Konzept, das Sie erklären, hervorzuheben und gleichzeitig technische Komplexität zu vermeiden, die für den vorliegenden Punkt nicht relevant ist.
Ich empfehle dringend, dass Sie Ihren Professor (oder den anderen, der Ihre Abschlussarbeit bewertet) fragen, wie sie dies erwarten.
Dafür gibt es keine allgemeingültige Regel, sondern es ist Geschmacks- und Geschmackssache.
Ich persönlich finde es sehr sinnvoll, Beispiele für theoretische Konzepte zu nennen.
Wenn Sie aber an verschiedenen Stellen Ihres Textes darauf verweisen, reicht es in der Regel aus, sie nur einmal anzugeben (z. B. beim ersten Zitat oder in einem Anhang) und dann an anderer Stelle im Text darauf zu verweisen (z. B. durch Beispielnummer).
Es ist ungewöhnlich, dass derselbe Code mehr als einmal in einer Abschlussarbeit oder einem Papier angegeben wird.
weißer Adler