Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
studentische_arbeiten:allgemeinen_hinweise_zur_schriftlichen_arbeiten [2024/09/05 15:40]
mexleadmin [3.8 Peculiarities of theses written in English] 		studentische_arbeiten:allgemeinen_hinweise_zur_schriftlichen_arbeiten [2024/09/19 22:29] (aktuell)
mexleadmin [3.2 Tabellen, Diagramme und Bilder]
Zeile 274: Zeile 274:
   - Ggf. Strichstärke ist die in Diagrammen zu erhöhen, damit diese nachher als Print noch gut zu erkennen sind.    - Ggf. Strichstärke ist die in Diagrammen zu erhöhen, damit diese nachher als Print noch gut zu erkennen sind. 
   - Prüfen Sie ob das Diagramm / Bild das Wesentliche gut zu sehen ist, ansonsten ist es sinnvoll die Komponente zu vergrößern bzw. nur einen Ausschnitt davon zu nutzen. Ggf. kann eine Markierung (Rahmen, Schattierung o.ä.) helfen.   - Prüfen Sie ob das Diagramm / Bild das Wesentliche gut zu sehen ist, ansonsten ist es sinnvoll die Komponente zu vergrößern bzw. nur einen Ausschnitt davon zu nutzen. Ggf. kann eine Markierung (Rahmen, Schattierung o.ä.) helfen.
-  - Bei der Softwarevisualisierung bieten sich **Funktionsflussdiagramme**, UML-Klassen/Objektdiagramme oder Ablaufdiagramme an. Gut ist eine Beschreibung, //wie// die Funktionen/Module miteinander interagieren (also mit Darstellung der Schnittstellen). Ich empfehle (lange) Code-Ausschnitte zu vermeiden. \\ Begründung: Da häufig Teile des Codes relevant sind, welche aber den Code-Kontext benötigen, ist man verleitet den Code-Kontext einzufügen. Dieser wiederum beinhaltet aber meist auch andere nicht relevante Passagen. Dies erzeugt beim Leser eine erhöhte "visual load" beim Verständnisaufbau.+  - Code Listings 
 +    - Ich empfehle (lange) Code-Ausschnitte zu vermeiden. \\ Begründung: Da häufig Teile des Codes relevant sind, welche aber den Code-Kontext benötigen, ist man verleitet den Code-Kontext einzufügen. Dieser wiederum beinhaltet aber meist auch andere nicht relevante Passagen. Dies erzeugt beim Leser eine erhöhte "visual load" beim Verständnisaufbau. 
 +    - Statt Code Listings bieten sich bei der Softwarevisualisierung **Funktionsflussdiagramme**, UML-Klassen/Objektdiagramme oder Ablaufdiagramme an. Gut ist eine Beschreibung, //wie// die Funktionen/Module miteinander interagieren (also mit Darstellung der Schnittstellen).  
 +    - Falls Sie Code einfügen (als Code-Snippets oder im Anhang), so sollten Zeilennummern und Syntax Highlighting genutzt werden. Dazu gibt es z.B. den Weg über %%Notepad++%% (siehe {{https://www.youtube.com/watch?v=d90qrJL7VvQ&ab_channel=PickUpBrain|Video}}).
   - Zitierte Bilder und Tabellen:   - Zitierte Bilder und Tabellen:
     - Bilder und Tabellen können generell auch als Zitat eingefügt werden. Diese müssen dann als solches hervorgehoben werden.      - Bilder und Tabellen können generell auch als Zitat eingefügt werden. Diese müssen dann als solches hervorgehoben werden.