Date: Mon, 1 Mar 2021 01:10:15 +0000 (UTC) Message-ID: <1180950019.441.1614561015186@0720069cea79> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_440_157538517.1614561015186" ------=_Part_440_157538517.1614561015186 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html Writing Advice

Writing Advice

 

Table of Contents

=20 =20

Size

Folgendes sind grobe Richtwerte f=C3=BCr den Umfang der Arbeit, ohne Tit= elseite, Inhalts-/Abbildungsverzeichnis, leere Seiten, Bibliographie, Anh= =C3=A4nge, etc.

Contents

Chapter Structure Example<= /h2>
  1. Abstract: Beschreibt den Inhalt Arbeit abstrakt und ko= mpakt, soll einem Leser eine Entscheidungshilfe dabei sein, ob die Arbeit f= =C3=BCr ihn lesenswert ist oder nicht.
  2. Einleitung: In das Thema einf=C3=BChren, Ziele der Arb= eit beschreiben, Ausblick/Kapitel=C3=BCbersicht geben.
  3. Verwandte Arbeiten: Arbeiten mit =C3=A4hnlichen/angren= zenden Themen in Bezug zur Arbeit setzen.
  4. Verwendete Technologien: Optional, Techniken und Techn= ologien soweit f=C3=BCr das Verst=C3=A4ndnis n=C3=B6tig beschreiben.
  5. Ideen: Vom Ist-Zustand ausgehend die Probleme er=C3=B6= rtern, L=C3=B6sungsans=C3=A4tze auch mit Verweis auf verwandte Arbeiten dis= kutieren und den eigenen L=C3=B6sungsweg stichhaltig begr=C3=BCnden, hier z= un=C3=A4chst die n=C3=B6tige Abstraktion wahren und erst im Verlauf konkret= er werden, Implementierungsdetails sind hier irrelevant.
  6. Implementierung: Mit Verweis auf den eigenen L=C3=B6su= ngsweg, soll hier die Implementierung zun=C3=A4chst mit der Struktur beginn= end (Begr=C3=BCndung!) und an sinnvollen Stellen auch mit konkretem Anwendu= ngscode/Beispielen beschrieben werden.
  7. Evaluation: Optional, Vergleich der Implementierung od= er des L=C3=B6sungsweges mit anderen Ans=C3=A4tzen, Experimente, Auswertung= , Bewertung.
  8. Zusammenfassung, Fazit, Ausblick: Fasst die Probleme u= nd vor allem die aufgezeigten L=C3=B6sungen/Ergebnisse zusammen und beschre= ibt als Ausblick auch Erweiterungsm=C3=B6glichkeiten, Schlie=C3=9Ft mit ein= em knappen und f=C3=BCr die Arbeit aussagekr=C3=A4ftigen Fazit.

Language

Sie k=C3=B6nnen die Arbeit auf Deutsch oder Englisch verfassen. Falls Si= e die Arbeit nicht in Ihrer Muttersprache schreiben, w=C3=A4re es hilfreich= , wenn ein muttersprachlicher (oder =C3=A4hnlich qualifizierter) Korrekturl= eser Ihre Arbeit auf sprachliche Richtigkeit korrigieren k=C3=B6nnte, bevor= Sie die Arbeit Ihrem Betreuer geben.

Software sollte generell auf Englisch geschrieben werden - d.h., Komment= are, Variablen-/Klassen-/Paketnamen etc. sollten englisch sein.

Advice on Theses Wr= itten in English

Schlecht:

=E2=80=9EBut this is of exponential compl= exity. And there is no known alternative.=E2=80=9C

Gut:

=E2=80=9EHowever, this is of exponential = complexity. Furthermore, there is no known alternative.=E2=80=9C

Schlecht:

=E2=80=9EI, like you, like fast algorithm= s, like Tarjan's algorithm, ... He uses a sorting algorithm of quadratic co= mplexity, like there is no alternative.=E2=80=9C

Gut:

=E2=80=9EI, like you, like fast algorithm= s, such as Tarjan's algorithm, ... He uses a sorting algorithm of quadratic= complexity, as if there were no alternative.=E2=80=9C

Schlecht:

=E2=80=9EI told him, that the quicksort a= lgorithm that is very fast is used by the program, which I installed yester= day.=E2=80=9C

Gut:

=E2=80=9EI told him that the quicksort al= gorithm, which is very fast, is used by the program that I installed yester= day.=E2=80=9C

Schlecht:

=E2=80=9EThe following Section illustrate= s .... In section 2.3, we describe .... This Chapter includes too many Sect= ions.=E2=80=9C

Gut:

=E2=80=9EThe following section illustrate= s .... In Section 2.3, we describe .... This chapter includes too many sect= ions.=E2=80=9C

Use a Spell Checker

Lassen Sie von Zeit zu Zeit eine Rechtschreibpr=C3=BCfung =C3=BCber ihre= n Text laufen; dies ist auch f=C3=BCr .tex-Dateien m=C3=B6glich. Insbesonde= re sollte dies geschehen bevor Sie Ihre Arbeit jemand anderem zum Lesen/Kor= rigieren/Bewerten geben. Ein m=C3=B6glicher Spellchecker ist aspell.

Texlipse unterst=C3=BCtzt auch on-the-fly spell checking.

In Emacs (oder Xemacs - generell wird hier nicht zwischen diesen Editore= n unterschieden) wird die Rechtschreibpr=C3=BCfung eines Buffers, welcher e= ine .tex-Datei enthalten kann, mit dem Befehl ispell-buffer gesta= rtet. Der zu verwendende Spellchecker wird durch die Variable ispell-p= rogram-name definiert (Default: aspell). Das zu verwendende W=C3= =B6rterbuch wird durch die Variable ispell-dictionary definiert (= z.B. deutsch8 oder american), welche durch den Befehl i= spell-change-dictionary gesetzt werden kann.

Emacs kann das zu verwendende W=C3=B6rterbuch auch automatisch f=C3=BCr = eine .tex-Datei festlegen, wenn die Datei die Variable ispell-dictiona= ry =C3=BCber einen Local Variables-Kommentar definiert, = welcher vom Emacs beim Einlesen einer Datei ausgewertet wird. Ein Beispiel = f=C3=BCr einen solchen Kommentar:

  % Local Variables:
  % mode: latex
  % compile-command: "make cases2005.pdfv"
  % ispell-dictionary: "american"
  % End:

Emphases

Einzelne Textpassagen k=C3=B6nnen ausgezeichnet werde= n. Grunds=C3=A4tzlich sollten Auszeichnungen in folgenden Gegebenheiten ein= gesetzt werden:

Man sollte sich beim Gebrauch von Auszeichnungen bewusst sein, dass dies= e ein besonderer Hinweis f=C3=BCr den Leser sind und ihn zu besonderer Aufm= erksamkeit veranlassen sollen. Sie bewirken stets eine - wenn auch minimale= - Unterbrechung des Leseflusses. Auszeichnungen sollten systematisch und i= m Zweifelsfall eher sparsam eingesetzt werden. Zu vieleAuszei= chnungen verhindern das fl=C3=BCssige Lesen (und k=C3=B6nnen auch etwas akademisch wirken). E= s ist dann schwierig f=C3=BCr den Leser zu erke= nnen, was denn nun wirklich wichtig ist - insbesondere bei ge= schachtelten Auszeichnungen, m=C3=B6glicherweise mehrfach =C3= =BCberlagert !!!!

Bei Auszeichnungen sollte der Scope eingehalten werde= n. Wenn z.B. Begriffe und sowie deren Abk=C3=BCrzungen eingef=C3=BChrt werd= en, sollten diese einzeln ausgezeichnet werden - Klammerungen selbst sollte= n nicht ausgezeichnet werden.

Schlecht:

=E2=80=9EDie Message Sequence Charts (MSCs) sind ein Formalismus ...=E2= =80=9C

Gut:

=E2=80=9EDie Message Sequence Charts (MSCs) sind ein Formalismu= s ...=E2=80=9C

In LaTeX werden Auszeichnungen mit dem Befehl \emph vorgenomme= n, welche dann normalerweise kursiv erscheinen. In einem kursiv gesetzten Kontext - wie in den Beispielen hier - sind Ausz= eichnungen jedoch nicht-kursiv, um diese vom Kontext abzuhebe= n.

Foreign Language Passages<= /h2>

Zun=C3=A4chst ein Beispiel f=C3=BCr ein englischsprachiges Dokument:

Schlecht:

=E2=80=9EAs Schmidt et al. have documented, this agreement today is a de= -facto standard for layout etc.=E2=80=9C

Gut:

=E2=80=9EAs Schmidt et al. have documented, this agreement= today is a de-facto standard for layout etc.=E2=80=9C

Bei deutschsprachigen Dokumenten gilt: es sind grunds=C3=A4tzlich Begrif= fe ausgenommen, welche im Duden stehen (wie zum Beispiel =E2=80=9ELayout=E2= =80=9C). Weiterhin wird bei Auszeichnungen die Gro=C3=9F-/Kleinschreibung d= er Fremdsprache =C3=BCbernommen.

Schlecht:

=E2=80=9EWie Schmidt et al. dokumentiert haben, ist dieses Agreement heu= te de-facto ein Standard in layout etc.=E2=80=9C

Gut:

=E2=80=9EWie Schmidt et al. dokumentiert haben, ist diese Vereinbarung h= eute de-facto ein Standard in Layout etc.=E2=80=9C

Eine spezielle Problematik bei deutschsprachigen Dokumenten in der Infor= matik ist, dass hier viele Begriffe aus dem Englischen kommen, und als Teil= des deutschen Informatik-Fachvokabulars angesehen werden k=C3=B6nnen, auch= wenn diese noch nicht im Duden erscheinen. Diese Begriffe sollten dann nic= ht ausgezeichnet werden, damit die Lesbarkeit des Dokuments nicht durch =C3= =BCberm=C3=A4=C3=9Fige Auszeichnungen leidet. Im Zweifelsfall gilt: Wenn es= f=C3=BCr einen englischen Begriff keinen =C3=A4quivalenten deutschen Begri= ff gibt, oder der deutsche Begriff in der Praxis seltener eingesetzt wird a= ls der englische Begriff, sollte der englische Begriff als Teil des deutsch= en Fachvokabulars angesehen werden und auf eine Auszeichnung verzichtet wer= den. Dies betrifft auch Begriffe, welche nicht wirklich Fachbegriffe sind (= wie z.B. =E2=80=9EFeature=E2=80=9C). Ebenso sollten Eigennamen von Formalis= men, Programmiersprachen, Werkzeugen usw. nicht ausgezeichnet werden. In je= dem Fall sollten Sie sich konsistent f=C3=BCr oder gegen die Auszeichnung e= ines Begriffs im gesamten Dokument entscheiden; einzige Ausnahme ist die ei= nmalige Auszeichnung eines Begriffes bei einer Begriffsdefinition. Zusammen= fassend gilt: es ist oft im Ermessen des Autors, ob eine Auszeichnung verwe= ndet werden soll oder nicht; im Zweifelsfall gilt das Gebot der Sparsamkeit= , insbesondere, falls Sie einen einzelnen Begriff sehr h=C3=A4ufig verwende= n.

Schlecht:

=E2=80=9EDie Synthese von Statecharts nach Java .... Der Kellerspeicher = vom =C3=9Cbersetzer ist hierf=C3=BCr standardm=C3=A4=C3=9Fig zu klein. Dies= e software hat viele features und noch mehr bugs. [Aber:] Die Mental Map de= s Betrachters ....=E2=80=9C

Gut:

=E2=80=9EDie Synthese von Statecharts nach Java .... Der Stack des Compi= lers ist hierf=C3=BCr standardm=C3=A4=C3=9Fig zu klein. Diese Software hat = viele Features und noch mehr Bugs. [Aber:] Die mental map des Betrachters .= ...=E2=80=9C

Nach diesem Pl=C3=A4doyer f=C3=BCr die sparsame Verwendung von Auszeichn= ungen bei origin=C3=A4r englischen Ausdr=C3=BCcken noch ein Pl=C3=A4doyer f= =C3=BCr sparsame Verwendung englischer Ausdr=C3=BCcke, wenn es hierf=C3=BCr= g=C3=A4ngige und pr=C3=A4zise =C3=84quivalente im Deutschen gibt:

Schlecht:

=E2=80=9EDas Agreement war, die Action Items und die Schedule des n=C3= =A4chsten Meetings in die Minutes zu pasten, und sich zum Matchen der Deadl= ines zu committen.=E2=80=9C

Gut:

=E2=80=9EDie Vereinbarung war, die Aktionspunkte und die Zeitplanung der= n=C3=A4chsten Besprechung in das Protokoll zu =C3=BCbernehmen, und sich zu= r Einhaltung der Termine zu verpflichten.=E2=80=9C

In der Informatik ist dies oft eine schwierige Balance zwischen zu viel = und zu wenig deutsch, welche letztlich eine Sache des pers=C3=B6nlichen Ges= chmacks ist. So scheint =E2=80=9E=C3=9Cbersetzer=E2=80=9C ebenso akzeptabel= wie =E2=80=9ECompiler=E2=80=9C, =E2=80=9EBetriebssystem=E2=80=9C mehr verb= reitet als =E2=80=9EOperating System=E2=80=9C, jedoch wirkt =E2=80=9EKeller= speicher=E2=80=9C eher verschroben im Vergleich zu =E2=80=9EStack=E2=80=9C.=

Symbols, Physical Units= , etc.

Neben den bereits erw=C3=A4hnten F=C3=A4llen, in welchen Textbestandteil= e ausgezeichnet werden sollten, sollten auch Mathematische Symbole, Mengenb= ezeichner, physikalische Gr=C3=B6=C3=9Fen etc. ausgezeichnet werden. In LaT= eX kann man hierf=C3=BCr, wie bereits erw=C3=A4hnt, den Befehl \emph{...} v= erwenden - oder alternativ den Begriff mit =E2=80=9E$...$=E2=80=9C auszeich= nen. Letzterer Mechanismus ist jedoch mit etwas Vorsicht zu verwenden, fall= s die Begriffe mehr als ein Zeichen lang sind, da dieser Mechanismus den Be= griff als mathematische Formel interpretiert und spezielle Richtlinien f=C3= =BCr dessen Layout verwendet. Insbesondere wird der Buchstabe f als eigenst= =C3=A4ndiger Funktionsname interpretiert und ein entsprechender Zwischenrau= m produziert, was generell nicht erw=C3=BCnscht ist.

Schlecht:

=E2=80=9ESei $Koffer$ die Menge der Koffer ...=E2=80=9C

Gut:

=E2=80=9ESei \emph{Koffer} die Menge der Koffer ...=E2=80=9C

Programs, Function Nam= es, etc.

Namen von Programmen sowie von Funktionsnamen, Variablennamen etc. sollt= en ebenfalls ausgezeichnet werden. Jedoch sollte man hierf=C3=BCr eine ande= re Auszeichnung verwenden, n=C3=A4mlich diejenige, welche auch in Programml= istings verwendet wird. Typischerweise ist dies typewriter (erzeugt mit \te= xttt{...}) oder SansSerif (erzeugt mit \textsf{...}). Ein Beispiel hierf=C3= =BCr sind die in diesem Text erw=C3=A4hnten LaTeX-Befehle.

References

Verwenden Sie Referenzierungen im Ihrer Arbeit so, dass sie kein grammat= ikalischer Bestandteil des Satzes sind - der Text sollte auch nach Eliminie= ren aller geklammerten Bestandteile, einschlie=C3=9Flich der in eckigen Kla= mmern befindlichen Referenzen, noch grammatikalisch korrekt sein. =C3=9Cbli= cherweise erreicht man dies durch die Nennung der Autoren eines Werkes, gef= olgt von der Referenz. Im Text sollten Autoren typischerweise ohne Vornamen= genannt werden (jedoch sollten Autorenvornamen bei den Referenzen selbst v= ollst=C3=A4ndig genannt werden, siehe unten). Bei mehreren Autoren sollten = entweder alle genannt werden, oder es sollte die Existenz weiterer Autoren = durch =E2=80=9Eet al.=E2=80=9C kenntlich gemacht werden.

The citation comes at the end of the sentence, yet it appears inside= the period (because it is part of the sentence). If the citation is p= receded by a quotation from the cited work, then the citation is placed outside the quotation marks (because it isn=E2=80=99t part of the quo= tation) [LitWeb]

Schlecht:

=E2=80=9EWie in [42] beschrieben, ...=E2=80= =9C

Gut:

=E2=80=9EWie von Harel et al. beschrieben= , ... [42]=E2=80=9C

The citation comes at the end of the sentence, yet it appears inside= the period (because it is part of the sentence). If the citation foll= ows a quotation from the cited work, then the citation is placed outsid= e the quotation marks (because it isn=E2=80=99t part of the quotation)= .

Vor Referenzen steht eine Leerstelle, hier sollte aber nicht umgebr= ochen werden  (in Latex: ~).

Schlecht:

=E2=80=9EWie von Harel[42] beschrieben, ...=E2=80= =9C

Gut:

=E2=80=9EWie von Harel [42] beschrieben, ...=E2=80= =9C

Die Referenzen selbst sollten vollst=C3=A4ndig sein - also mehr sein als= eine Sammlung von Suchbegriffen f=C3=BCr google. Grunds=C3=A4tzlich sollte= n Angaben so vollst=C3=A4ndig wie m=C3=B6glich sein. So geh=C3=B6ren z.B. z= u einer Artikelreferenz nicht nur Autoren und Titel des Artikels, sondern a= uch bei Jahr/Monat des Erscheinens, bei Journalartikeln auch Name des Journ= als und gegebenenfalls Nummer und Herausgeber, sowie bei Tagungs-/Workshopa= rtikeln der Name und Ort der Tagung. Vermeiden Sie Abk=C3=BCrzungen. Tagung= snamen sollten sowohl in ausgeschriebener Form als auch mit ihrem K=C3=BCrz= el genannt werden.

Schlecht:

=E2=80=9EA. Mooij and N. Goga and J. Romijn. Non-local Choice and Beyond= : Intricacies of MSC Choice Nodes. FASE'05, pages 273-288, 2005.=E2=80=9C = =E2=80=9EA. Mooij and N. Goga and J. Romijn. Non-local Choice and Beyond: I= ntricacies of MSC Choice Nodes. In Fundamental Approaches to Software Engin= eering, pages 273-288, April 2005.=E2=80=9C

Gut:

=E2=80=9EArjan J. Mooij and Nicolae Goga and Judi Romijn. Non-local Choi= ce and Beyond: Intricacies of MSC Choice Nodes. In Fundamental Approaches t= o Software Engineering (FASE '05), pages 273-288, Edinburgh, Scotland, Apri= l 2005.=E2=80=9C

Achten Sie auf die Konsistenz der Eintr=C3=A4= ge. So sollten z.B. alle Referenzen f=C3=BCr ein Journal dieses Journal gle= ich referenzieren. Autoren sollten so referenziert werden, wie sie in der r= eferenzierten Arbeit erscheinen; so sollten Vornamen nicht abgek=C3=BCrzt w= erden, wenn sie in der Arbeit selbst ausgeschrieben sind, ebenso sollten an= gegebene Mittelinitialen =C3=BCbernommen werden. Bei der Verwendung von URL= s sollten Sie darauf achten, dass diese nicht =C3=BCber den Satzspiegel hin= ausragen; das Paket breakurl sorgt f=C3=BCr den entsprechenden Ze= ilenumbruch von URLs.

Schlecht:

[1] Alur, Etessami, and Yannakakis. Inference of m= essage sequence charts. IEEETSE: IEEE Transactions on Software Eng= ineering, 29, 2003.

[2] Alan W. Biermann and Ramachandran Krishnaswamy= . Constructing programs from example computations. IEEE Transactions on Sof= tware Engineering, 2(3):141-153, September 1976.

Gut:

[1] Rajeev Alur, Kousha Etessami, and Mihalis Yann= akakis. Inference of message sequence charts. IEEE Transactions on= Software Engineering, 29:304NAK313, 2003.

[2] Alan W. Biermann and Ramachandran Krishnaswamy= . Constructing programs from example computations. IEEE Transactio= ns on Software Engineering, 2(3):141-153, September 1976.

Die Bibliographie sollte nach Nachnamen des Erstautors sortiert sein. Be= i der (stark empfohlenen) Verwendung von BibTeX sollten Sie f=C3=BCr jede R= eferenz den richtigen, m=C3=B6glichst spezifischen Referenztyp verwenden (z= .B. @InProceedings statt @Misc). Die f=C3=BCr den jeweiligen= Referenztyp vorgesehenen Pflichtfelder geben bereits einen ersten Hinweis = f=C3=BCr die Mindestinformationen; die weiteren optionalen Eintragsfelder s= ollten aber auch so weit wie m=C3=B6glich verwendet werden. Falls bibt= ex bei Erzeugung der Referenzen einen Fehler meldet, z.B. aufgrund ein= es fehlenden Pflichtfeldes, sollte dieses auf alle F=C3=A4lle korrigiert we= rden. F=C3=BCr Ihre Arbeitserleichterung sollten Sie ein konsistentes Schem= a f=C3=BCr die Indizierung verwenden, so dass Sie den Index m=C3=B6glichst = aus Autoren & Erscheinungsjahr erschlie=C3=9Fen k=C3=B6nnen, und Refere= nzierungen in Ihren Text einf=C3=BCgen k=C3=B6nnen, ohne den Index in der B= ibTeX-Datei nachsehen zu m=C3=BCssen. Die Verwendung eines bestimmten Schem= as ist insbesondere dann erforderlich, falls Sie eine gemeinsam genutzte Bi= bTeX-Datei bearbeiten. So gibt z.B. die am Lehrstuhl genutzte cau-rt.b= ib-Datei ein Schema vor, welches am Anfang dieser Datei beschrieben ist.

  • Literaturangaben m=C3=B6glichst als integrierten Teil des Satzes (nicht= au=C3=9Ferhalb des Satzes anbringen).
  • Literaturangaben keinesfalls hinter das Satzendzeichen (z.B. nach dem P= unkt).
  • Auch in Abbildungen, die nicht selbst/selbst=C3=A4ndig erstellt wurden = darf die Literaturangabe nicht fehlen (z.B. (nach Schmidt [3])).
  • F=C3=BCr URLs, Verweise auf Webseiten (z.B. www.eclipse.org) eigne= n sich am besten Fu=C3=9Fnoten.
  • Bib-Eintr=C3=A4nge kontrollieren (Titel, Autoren (durch and getrennt, n= icht kommasepariert!), Datum, Ort!).
  • Bib-Eintr=C3=A4ge: W=C3=B6rter, die gro=C3=9F geschrieben werden sollte= n in geschweifte Klammern setzen.
  • Bib-Eintr=C3=A4ge auf Englisch oder Deutsch (je nach Arbeit!).
  • Literaturangaben nicht als Nomen in den Satz einbetten. 
    Merkre= gel: Der Satz sollte sich auch ohne die Literaturangabe sinnvoll lesen lass= en.
  • Nur Prim=C3=A4rliteratur oder (bew=C3=A4hrte) Fachb=C3=BCcher: Z.B. kei= ne Foliens=C3=A4tze/Lectures referenzieren.

Acronyms

Figures and Listings

Cross References

  • Bezeichnung sollte korrekt sein: z.B. Kapitel 2, Unterkapitel 2.1, Absc= hnitt 2.3.4, Absatz
    • Nicht: z.B. Kapitel 2.1
  • R=C3=BCckw=C3=A4rtsverweise sind ok, Vorw=C3=A4rtsverweise sind zu verm= eiden.
  • Zu viele Verweise st=C3=B6ren den Lesefluss, wichtige Dinge sollten an = geeigneter Stelle auch (evtl. k=C3=BCrzer) wiederholt werden.
  • Abbildungen/Tabellen immer konkret benennen.

General Syntax

  • Doppelpunkt als Teil des Satzes auffassen; nach : so= llte kein neuer Absatz beginnen.
  • Hervorheben von W=C3=B6rtern (\emph{}) m=C3=B6glichst selten einsetzen = (s.o.).
  • Fremdsprachenw=C3=B6rter kursiv hervorheben.
  • Klammern vermeiden, sie st=C3=B6ren den Lesefluss.
  • Fu=C3=9Fnoten vermeiden, sie st=C3=B6ren den Lesefluss.
  • Fu=C3=9Fnoten f=C3=BCr URLs sind ok.
  • M=C3=B6glichst auf Querseiten verzichten, sie st=C3=B6ren den Lesefluss= .
  • Keine Einzelzeilen oder =C3=9Cberschriften vor oder nach einem Seitenum= bruch stehen lassen.
  • Es sollten keine Zeilen oder Abbildungen/Tabellen =C3=BCber den Rand hi= nausragen.
  • Auf unn=C3=B6tigen Whitespace verzichten.
  • Codefont f=C3=BCr Funktionsnamen/Prozeduren/... verwenden und auch hier= auf Konsistenz achten.
  • LaTeX kennt keine Abk=C3=BCrzungs-Punkte. Z.B. Bei "e.g." oder "et al."= ein xspace hinter dem letzten Punkt verwenden, da ansonsten ein zu gro=C3= =9Fer Abstand zum n=C3=A4chsten Wort erzeugt wird (wie beim Satzende).

Style

  • F=C3=BCllw=C3=B6rter, F=C3=BCllphrasen und F=C3=BClls=C3=A4tze vermeide= n, z.B.
    • due to the fact that
    • in order to
  • Zusammenh=C3=A4nge: "It" oder "This" vermeiden, wenn der Zusammenhang n= icht wirklich eindeutig klar ist. In der Regel lieber den Bezug noch einmal= explizit zum Ausdruck bringen.
  • Passiv in S=C3=A4tzen nach M=C3=B6glichkeit vermeiden:
    • Schlecht: =E2=80=9EThe syntax is explained in Chapter 5=E2=80=9C
    • Gut: =E2=80=9EChapter 5 explains the syntax=E2=80=9C
  • Wir/Ich-S=C3=A4tze vermeiden. Ausnahme: Es geht um den inhaltlichen Ker= nbeitrag.

Appendix

  • Wesentliche Teile, die im Text wichtig sind, nicht im Anhang verstecken= .
  • Anleitungen (z.B. How-Tos) geh=C3=B6ren in den Anhang.
------=_Part_440_157538517.1614561015186--
https://rtsys.informatik.uni-kiel.de/confluence/exportword?pageId=7700971
rtsys.informatik.uni-kiel.de
crawl=CC-MAIN-2021-10
41229
application/http; msgtype=response
sha1:DTMUALIFXLRPGY7SQK4F6GCZYFXKOTDP
<urn:uuid:352c614f-aac0-47ef-83ba-44862de9a8fb>
2021-03-01T01:10:15Z
134.245.253.156
message/rfc822
sha1:TZBYHKTFWMPNXEJNK7KGDBOVLJ66VEDX
<urn:uuid:1e42c7c5-b39b-428d-b59d-9023c7a2447f>
https://rtsys.informatik.uni-kiel.de/confluence/exportword?pageId=7700971
response
<urn:uuid:b2de4d71-b7d5-4460-8475-8a6274842650>
isPartOf: CC-MAIN-2021-10
publisher: Common Crawl
description: Wide crawl of the web for February/March 2021
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-67-67-215.ec2.internal
software: Apache Nutch 1.18 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.2-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: http://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/