Anmerkung Entwicklung eines Computerspielers -> Java

[SturmEnte]

Anmerkungen zum Java-Teil der Dokumentation. Bitte um Feedback, sobald ich das erhalten habe, werde ich die besprochenen Anpassungen umsetzen und eine PR eröffnen.

https://docs.software-challenge.de/entwicklung/java/installation-von-java#installation

• Es fehlt ein Tutorial für Mac.

https://docs.software-challenge.de/entwicklung/java/installation-von-java#installation-ber-paketquellen-linux

• Installationbefehle für die gängigsten Packagemanager wie apt (wie beim Windows-Teil) hinzufügen

https://docs.software-challenge.de/entwicklung/java/einfuehrung-oop#statische-variablen-und-methoden

• Das d bei 2.5 ist überflüssig, weil der standart Datentyp für Kommazahlen in Java double ist und durch das double von der Variable ist es klar, dass es sich um einen double handelt.
• Genauso bei dem Beispielcode darunter (3d)

https://docs.software-challenge.de/entwicklung/java/sauberer-programmierstil#klammerungsregeln

• Vielleicht Beispiele wie aus bsp. x wird bsp. y damit die Regeln klarer werden. Also einmal in falsch und dann die korekte Version.

https://docs.software-challenge.de/entwicklung/java/sauberer-programmierstil#die-switchanweisung

• Kommentar in case 1 könnte möglicherweise verwirren und Kommentare wurden an diesem Punkt noch nicht erklärt.
• Da stellt sich auch die Frage, ob sich das an Leute mit Programmiererfahrung in anderen Programmiersprachen oder an komplette Anfänger richtet.
  Falls an Anfänger, sollte man noch einen ganz neuen Teil hinzufügen, in dem generell Basics erklärt werden.

https://docs.software-challenge.de/entwicklung/java/einrichtung-der-entwicklungsumgebung

• Großer Fokus auf Eclipse. Unterstützen wir das noch offiziel?
• IntelliJ-Teil über Eclipse packen, weil das relevanter für die Teilnehmer ist.

https://docs.software-challenge.de/entwicklung/java/einrichtung-der-entwicklungsumgebung#spielervorlage-in-intellij-einbinden

• Warum genau Version 15?
• Beim befolgen der Schritte wird von ItelliJ per Popup empfolen eine bestimmte Java Version zu installieren, auf meinem Linux Laptop und ich glaube auch bei den Schülern der GHO auf Windows 10 wurde Version 11 vorgeschlagen und damit funktioniert das auch

https://docs.software-challenge.de/entwicklung/java/bedienung-von-eclipse

• Falls Eclipse nicht mehr unterstützt wird ist dieser Teil überflüssig.
• Eine ähnliche Seite für IntelliJ erstellen

https://docs.software-challenge.de/entwicklung/java/simpleclient-erweitern#erstellen-einer-neuen-strategie

• Klasse mit der Logic heißt im aktuellen Client "Logic" statt "MyLogic". Kann bei neuen Entwicklern durchaus verwirren.
• Weitere Methoden der API erklären und auflisten, damit die Schüler wissen was es gibt (bsp. GameRuleLogic)

[soerendomroes]

Es fehlt ein Tutorial für Mac.

Du kannst gerne ein Mac-Tutorial erstellen. @xeruf läuft alles auch auf Mac?

Installationbefehle für die gängigsten Packagemanager wie apt (wie beim Windows-Teil) hinzufügen

Vielleicht die entsprechenden Docu-Seiten der Betriebssysteme zusätzlich verlinken https://wiki.ubuntuusers.de/Java/Installation/OpenJDK/

Das d bei 2.5 ist überflüssig, weil der standart Datentyp für Kommazahlen in Java double ist und durch das double von der Variable ist es klar, dass es sich um einen double handelt.
Genauso bei dem Beispielcode darunter (3d)

Pass das gerne an.

Vielleicht Beispiele wie aus bsp. x wird bsp. y damit die Regeln klarer werden. Also einmal in falsch und dann die korekte Version.

Die Anmerkung verstehe ich nicht

Kommentar in case 1 könnte möglicherweise verwirren und Kommentare wurden an diesem Punkt noch nicht erklärt.

Ich denke, die Anleitung muss nicht die Anforderungen eines Lehrbuchs erfüllen. Ich denke, dass das ok ist.

Da stellt sich auch die Frage, ob sich das an Leute mit Programmiererfahrung in anderen Programmiersprachen oder an komplette Anfänger richtet.
Falls an Anfänger, sollte man noch einen ganz neuen Teil hinzufügen, in dem generell Basics erklärt werden.

Ich denke, wir sollten nicht versuchen Dokumentation, die auch sehr gut an anderen Orten zu finden ist, bei uns zu replizieren, da wir diese schwer warten können.

Großer Fokus auf Eclipse. Unterstützen wir das noch offiziel?
IntelliJ-Teil über Eclipse packen, weil das relevanter für die Teilnehmer ist.

Eclipse scheint noch zu gehen und ich denke, wir sollten unterstützen, was auch immer funktioniert und was eventuell bei Schulen mit älteren Systemen zu finden ist.
Da IntelliJ in Video von @TomekRD erklärt wird, denke ich, dass wir das tauschen können.

Warum genau Version 15?
Beim befolgen der Schritte wird von ItelliJ per Popup empfolen eine bestimmte Java Version zu installieren, auf meinem Linux Laptop und ich glaube auch bei den Schülern der GHO auf Windows 10 wurde Version 11 vorgeschlagen und damit funktioniert das auch

Ich denke wir sollten hier die Long Time Support (LTS) Version nehmen die wir unterstützen können. Entsprechend sollten wir Java 11 empfehlen.
@TomekRD du hattest im Video auch Java 15 benutzt. Magst du dazu etwas sagen?

Falls Eclipse nicht mehr unterstützt wird ist dieser Teil überflüssig.
Eine ähnliche Seite für IntelliJ erstellen

Ich denke Eclipse bräuchte mal neue Screenshots. Ja, ich denke, dass sollte es auch für IntelliJ geben.

Klasse mit der Logic heißt im aktuellen Client "Logic" statt "MyLogic". Kann bei neuen Entwicklern durchaus verwirren.

Hier soll Logic umbenannt werden. Entsprechend ist MyLOgic ok.

Weitere Methoden der API erklären und auflisten, damit die Schüler wissen was es gibt (bsp. GameRuleLogic)

Ich würde nur Klassen erklären, welche auch in allen Spielen vorkommen werden. Aber das hört sich gut an.

[xeruf]

ja läuft auf Mac - Homebrew nutz ich da für die jdk-installation

JDK 11 ist korrekt, steht ja auch so in der installation - ich glaub die Sektion wo das drin steht hat @TomekRD letztens ergänzt

GameRuleLogic war mal intern, aber ich hab es für Schüler zugänglich gemacht weil es halt eher "plumbing"-Arbeit ist.
Aber vielleicht ist das auch gut wenn es nicht so beworben ist, damit neulinge sich auch mal einen moment nehmen und diese basisfunktionen selbst implementieren.

mach für sowas am besten ein pull request, dann können wir direkt am code diskutieren und mit einzelnen threads für jedes thema arbeiten

[SturmEnte]

In der PR sind schonmal die kleineren Anpassungen, die größeren mache ich dann in den nächsten Tagen/Wochen