magicmarcy.de | Dokumentation

Dokumentation

Hier findest du alle Beiträge die mit dem Tag Dokumentation versehen sind.

Eine ganze Generation verlernt das Suchen

Zwischen den Zeilen • 21. Juli 2026 • Lesezeit: 10 Minuten • Read later

KI ist bequem. Sehr bequem sogar. Du beschreibst ein Problem, bekommst eine Antwort, kopierst vielleicht noch ein Code-Beispiel und bist erst einmal weiter. Gerade beim Einstieg in Java fühlt sich das oft wie eine Abkürzung an. Und ja, manchmal ist es auch eine. Wenn du gerade nicht weisst, wie eine for-Schleife aufgebaut ist, was eine NullPointerException bedeutet oder warum Maven eine Dependency nicht findet, kann dir KI schnell eine erste Richtung geben.

Das Problem beginnt dort, wo diese Richtung zur einzigen Quelle wird. Weiterlesen


Wenn Zahlen lügen: Magic Numbers sauber ersetzen

Java • 29. März 2026 • Lesezeit: 4 Minuten • Read later

Magic Numbers sind Zahlen (oder auch Strings), die irgendwo im Code „einfach so“ stehen und deren Bedeutung man nur errät. Du siehst dann 60, 3, 1024 oder "admin" und musst aus dem Kontext heraus rekonstruieren, warum genau dieser Wert dort steht. Zahlen im Code sind nicht per se schlecht. Schlecht wird es, wenn die Zahl eine fachliche oder technische Bedeutung trägt, diese Bedeutung aber nicht sichtbar ist. Weiterlesen


Java-Doc – es ist ein absolutes MUSS!

Java • 6. Juli 2021 • Lesezeit: 5 Minuten • Read later

Durch Dinge wie CleanCode oder dem KISS-Prinzip versuchen wir unseren Code möglichst verständlich zu halten. Wir benennen Methoden nachdem was sie tun, wissen, dass eine Methode auch nur eine Sache machen soll und auch die Benamung unserer Variablen sind sprechend.

Wer das alles konsequent berücksichtigt, der wird in den meisten Fällen keine Kommentare im Quelltext hinterlassen müssen – so zumindest der Wortlaut vieler Dozenten und Autoren.

In der Praxis sieht das oft aber ganz anders aus.

Weiterlesen


Über
Avatar

Hi, ich bin Marcel!
Als Fachinformatiker für Anwendungsentwicklung und IHK-geprüfter Ausbilder teile ich auf meinem Blog Grundlagen- und Fortgeschrittenen-Wissen für angehende Entwickler*innen und Interessierte, sowie weitere spannende Themen aus der IT.

Blog Aktivität

Aug
 
 
 
Sep
 
 
 
Oct
 
 
 
Nov
 
Mon
Wed
Fri