Merge branch 'main' of github.com:software-challenge/docs

Author: soerendomroes

hyperbook/book/grundlagen/server.md

@@ -22,7 +22,7 @@ und sogar als Mensch mitspielen.
 ## System vorbereiten und Spielleiter starten
 
 Die einzige Voraussetzung ist
-die [Installation einer Java-Laufzeitumgebung](/entwicklung/installation-von-java).
+die [Installation einer Java-Laufzeitumgebung](/entwicklung/java/installation-von-java).
 dass auf dem Rechner mindestens die Laufzeitumgebung für Java 11 installiert ist.
 
 Nach der erfolgreichen Installation kann man den grafischen Server
@@ -176,7 +176,7 @@ So nutzt du ihn
 
 Es ist möglich, statt eines zufällig generierten vollständigen Spielplanes
 eine Spielsituation zu laden und zu testen.
-Die Spielsituation muss vorher wie unter [Spielsituation nachstellen](#spielsituation-nachstellen) erzeugt werden.
+Die Spielsituation muss vorher wie unter [Spielsituation nachstellen](grundlagen/server#spielsituation-nachstellen) erzeugt werden.
 Dann kann die Datei mit dem Argument `--loadGameFile` geladen werden
 und optional mit `--turn` ein Zug spezifiziert werden.
 ```sh
@@ -204,7 +204,7 @@ dass Computerspieler wegen Zugzeitüberschreitungen vom Server disqualifiziert w
 Dies passiert, obwohl der Zug innerhalb der erlaubten Zugzeit
 (abhängig vom Spiel, bisher aber immer zwei Sekunden)
 an den Server geschickt wurde.
-Der Garbage Collector der Java Virtual Machine löst dieses Verhalten aus.
+Der [Garbage Collector](/faq#garbage-collector) der Java Virtual Machine kann dieses Verhalten auslösen.
 Er pausiert die Anwendung, um nicht mehr genutzten Speicher freizugeben.
 Wenn der Server dadurch zu einem ungünstigen Zeitpunkt angehalten wird,
 bemerkt er den Eingang des Zuges vom Computerspieler nicht rechtzeitig und disqualifiziert ihn daraufhin.
@@ -294,7 +294,11 @@ Unter Windows
 ```
 Der TestClient kann sich auch mit einem bereits laufenden Server verbinden,
 bei Angabe des Arguments `--start-server` startet er jedoch einfach selbst einen.
-Wichtig ist, dass nicht versucht wird, zwei Server auf dem selben Port zu starten.
+Bei folgender Fehlermeldung wurde der Server auf einem bereits belegten Port gestartet:
+```
+    Could not start server on port 13050
+    java.net.BindException: Address already in use
+```
 
 #### Argumente des TestClients
 
@@ -326,5 +330,10 @@ Ergebnisse werden erst zurückgesetzt, wenn der Server neu gestartet
 wird. Achte also nach einer Veränderung der Spieler darauf, den Server
 neu zu starten oder andere Spielernamen zu verwenden.
 
-Dieses Verhalten wird wahrscheinlich bald verändert,
-wobei dann jeder TestClient unabhängig vom Server die Punkte zählt.
+Die Ergebnisse der Spiele werden für den jeweiligen Spielernamen vom Server zusammengezählt,
+auch über mehrere Starts des TestClients.
+Die Ergebnisse werden erst zurückgesetzt,
+wenn der Server neu gestartet wird.
+Achte also nach einer Veränderung der Spieler darauf,
+den Serverneu zu starten oder andere Spielernamen zu verwenden.
+Perspektivisch soll der TestClient zukünftig unabhängig vom Server die Punkte zählen.

hyperbook/book/wettbewerb.md

@@ -6,68 +6,37 @@ expanded: true
 
 # Die Software-Challenge
 
-Die Software-Challenge ist ein Schulprojekt, das durch das Institut für
-Informatik der CAU Kiel veranstaltet wird und das durch zahlreiche
-Unternehmen, die Prof. Dr. Werner Petersen-Stiftung sowie das
-Ministerium für Wissenschaft, Wirtschaft und Verkehr des Landes
-Schleswig-Holstein finanziert wird. In Zusammenarbeit mit den Gymnasien
-und Gesamtschulen, dem Institut für Informatik sowie den Firmen soll in
-diesem Projekt der Informatik-Unterricht in praxisbezogener Weise
-mitgestaltet und dadurch aufgewertet werden. Gegenstand der
-Software-Challenge ist ein Programmierwettbewerb, der während des
-gesamten Schuljahres läuft, und der den Schülerinnen und Schülern die
-Möglichkeit bietet, mit Spaß und Spannung sowie mit kompetenter
-Begleitung in die Welt der Informatik einzusteigen. Am Ende der
-Entwicklungsphase schickt jedes Team (Kurs oder AG) einen selbst
-programmierten :t[Computerspieler]{#player} für das Spiel in den Wettkampf. Dieser
-Wettkampf besteht zunächst aus einer kompletten Meisterschaft (jeder
-gegen jeden) und anschließend aus einem Finale der 8 führenden Teams
-(Final Eight). Als Preise winken neben zahlreichen Sachpreisen auch
-Stipendien für die besten Schülerinnen und Schüler. In jeder Phase des
-Projekts wird in der Presse und im Radio über den jeweils aktuellen
-Stand berichtet.
+Die Software-Challenge ist ein Schulprojekt, das durch das Institut für Informatik der CAU Kiel veranstaltet wird und
+das durch zahlreiche Unternehmen und die Prof. Dr. Werner Petersen-Stiftung finanziert wird.
+In Zusammenarbeit mit den Gymnasien und Gesamtschulen, dem Institut für Informatik sowie den Firmen soll in diesem Projekt der Informatik-Unterricht in praxisbezogener Weise mitgestaltet und dadurch aufgewertet werden.
+Gegenstand der Software-Challenge ist ein Programmierwettbewerb,
+der während des gesamten Schuljahres läuft,
+und der den Schülerinnen und Schülern die Möglichkeit bietet, mit Spaß und Spannung sowie mit kompetenter
+Begleitung in die Welt der Informatik einzusteigen.
+Am Ende der Entwicklungsphase schickt jedes Team (Kurs oder AG) einen selbst programmierten [Computerspieler](/grundlagen/player) für das Spiel in den Wettkampf.
+Dieser Wettkampf besteht zunächst aus einer kompletten Meisterschaft (Gruppenphase und Champions) und anschließend aus einem Finale der 8 führenden Teams (Final Eight).
+Als Preise winken neben zahlreichen Sachpreisen auch Stipendien für die besten Schülerinnen und Schüler.
 
 ## Teilnahmebedingungen und Registrierung
 
-Teilnahmeberechtigt sind alle zur Hochschulreife führenden Schulen der
-Bundesrepublik Deutschland. Jede Schule kann sich dabei mit mehreren
-Kursen oder AGs (höchstens 3 Teams) anmelden. Jedes Team sollte dabei aus
-mindestens 3 Schülerinnen und Schülern und einer betreuenden Lehrkraft bestehen.
-Jeder Kurs bzw. jede AG darf nur ein Team anmelden. Dabei kann es in der
-Anfangsphase durchaus Sinn machen, intern in einem Team mehrere Gruppen
-zu bilden, um z.B. unterschiedliche Strategien zu testen und
-:t[Computerspieler]{#player} zu entwickeln. Spätestens zu Beginn der Wettkampfphase
-muss sich das Team jedoch auf einen :t[Computerspieler]{#player} einigen, der dann in
-den Wettkampf geschickt und dann eventuell noch gemeinsam
-weiterentwickelt wird. In begründeten Einzelfällen kann die
-Wettkampfleitung Ausnahmen von den zuvor genannten Regeln zulassen.
+Teilnahmeberechtigt sind alle zur Hochschulreife führenden Schulen der Bundesrepublik Deutschland.
+Jede Schule kann sich dabei mit mehreren Kursen oder AGs (höchstens 3 Teams) anmelden.
+Jedes Team kann dabei aus einer ganzen Klasse, einer Einzelperson oder eine kleinen Gruppe bestehen.
+Jeder Kurs bzw. jede AG darf nur ein Team anmelden.
+Dabei kann es in der Anfangsphase durchaus Sinn machen, intern in einem Team mehrere Gruppen
+zu bilden, um z.B. unterschiedliche Strategien zu testen und [Computerspieler](/grundlagen/player) zu entwickeln.
+Spätestens zu Beginn der Wettkampfphase muss sich das Team jedoch auf einen [Computerspieler](/grundlagen/player) einigen,
+der dann in den Wettkampf geschickt und dann eventuell noch gemeinsam weiterentwickelt wird.
+In begründeten Einzelfällen kann die Wettkampfleitung Ausnahmen von den zuvor genannten Regeln zulassen.
 
-Zurzeit nehmen pro Schuljahr etwa 100 Teams bundesweit an der
-Software-Challenge teil. Es werden dabei neben zahlreichen Sachpreisen
-auch etwa 100 Stipendien (6 Monate je 300 Euro) an die besten 100
-Schülerinnen und Schüler vergeben.
+Zurzeit nehmen pro Schuljahr etwa 40 Teams bundesweit an der Software-Challenge teil.
+Es werden dabei neben zahlreichen Sachpreisen auch Stipendien für die CAU Kiel oder die FH Wedel (12 Monate je 300 Euro) an von Lehrkräften empfohlene Schülerinnen und Schüler vergeben.
 
-Das Anmeldeverfahren sieht etwa wie folgt aus. Genaue Termine des
-aktuellen Zeitraumes finden sich auf der [Website unter
-Ablauf und Termine](https://software-challenge.de/ablauf-und-termine).
+Genaue Termine des aktuellen Zeitraumes finden sich auf der [Website unter Ablauf und Termine](https://software-challenge.de/ablauf-und-termine).
 
-Ab April können interessierte Lehrkräfte, Schülerinnen und Schüler 
-ihre Schulen und Teams für die Teilnahme an der Software-Challenge 
-unverbindlich anmelden. Diese Interessenten werden dann über 
-wichtige Termine und andere relevanten Dinge informiert.
-
-Gegen Ende der Anmeldungsphase werden wir dann mit den registrierten
-Interessenten in Verbindung treten. Dann soll eine (relativ)
-verbindliche Anmeldung erfolgen, sodass wir darauf aufbauend unsere
-Ressourcen planen können.
-
-Die endgültige Anmeldung soll dann zu Beginn des Schuljahres erfolgen.
-
-Um eine gute Planung und damit einen erfolgreichen Ablauf zu
-ermöglichen, sind wir darauf angewiesen, dass die interessierten
-Schulleiterinnen, Schulleiter, Lehrkräfte, Schülerinnen und Schüler ihre Schulen und Teams
-möglichst frühzeitig registrieren und erforderlichenfalls ihre Daten
-aktualisieren.
+Um eine gute Planung und damit einen erfolgreichen Ablauf zu ermöglichen, sind wir darauf angewiesen,
+dass die interessierten Schulleiterinnen, Schulleiter, Lehrkräfte, Schülerinnen und Schüler ihre Schulen und Teams möglichst frühzeitig registrieren
+und erforderlichenfalls ihre Daten aktualisieren.
 
 ## Die Aufgabe