Anmerkungen zu diversen Seiten

[soerendomroes]

Die "Docs" scheinen nicht immer ganz aktuell, ich habe angefangen mir alles mal durchzulesen und auszuprobieren.

@xeruf @TomekRD @YoEnte eventuell könnt ihr mehr zu bestimmten Anmerkungen sagen.

https://docs.software-challenge.de/wettbewerb

• sowie das Ministerium für Wissenschaft, Wirtschaft und Verkehr des Landes Schleswig-Holstein finanziert wird mittlerweile nicht mehr so
• Link Computerspieler nicht erreichbar
• 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) Gruppenphase, Champions-League und dann Final Eight.
• **In jeder Phase des Projekts wird in der Presse und im Radio über den jeweils aktuellen Stand berichtet. ** Ist das noch so?

https://docs.software-challenge.de/wettbewerb#teilnahmebedingungen-und-registrierung

• Jede Schule kann sich dabei mit mehreren Kursen oder AGs (höchstens 3 Teams) anmelden Ist höchstens 3 Teams immer noch aktuell?
• Jedes Team sollte dabei aus mindestens 3 Schülerinnen und Schülern und einer betreuenden Lehrkraft bestehen. Nicht mehr aktuell -> Ein Team kann aus einer Schülerin oder einem einzelnen Schüler bis zu einer ganzen Schulklasse bestehen
• Jeder Kurs bzw. jede AG darf nur ein Team anmelden Ist das richtig?
• Link Computerspieler nicht erreichbar
• Zurzeit nehmen pro Schuljahr etwa 100 Teams bundesweit an der Software-Challenge teil Das ist schon eine Weile nicht mehr. Eventuell nur "nehmen bundesweit Schulen 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. Das stimmt so nicht mehr oder? Wie viele Stipendium gibt es derzeit
• Das Anmeldeverfahren sieht etwa wie folgt aus. Nicht aktuell

https://docs.software-challenge.de/wettbewerb#die-aufgabe

• Link Computerspieler nicht erreichbar

https://docs.software-challenge.de/faq

• Zugang zu tech@...

https://docs.software-challenge.de/faq#technisch

• komplex sein Kkönnen
• und e. Es ist vollkommen in Ordnung

https://docs.software-challenge.de/grundlagen/player#der-computerspieler

• Dies ist der Link zum Computerspieler der oben falsch gesetzt ist
• Java SDK installiert nicht erreichbar
• Auf diese Weise müssen die Schülerinnen und Schüler nicht den ganzen Computerspieler selbst entwickeln -> Formulierung -> Neben dem eigentlichen Programm ist auch der Quellcode des Zufallsspielers verfügbar. Diesen Quellcode können Schülerinnen und Schüler anschauen und ihn um ihre eigene Strategie erweitern. Dadurch können sich die Schülerinnen und Schüler ganz auf den Entwurf und die Implementierung ihrer eigenen Strategie konzentrieren.
• Lösung der Aufgabe als der Zufallsspieler verfolgt und dadurch nicht mehr so leicht zu schlagen ist. -> redundant

https://docs.software-challenge.de/grundlagen/server#der-spielleiter-server

• Spielleiter heißt im Downloadbereich der Website "Server mit grafischer Oberfläche", außerdem "Computerspieler" heißt dort "Spielervorlagen"
• Installation einer Java-Laufzeitumgebung nicht erreichbar

https://docs.software-challenge.de/grundlagen/server#spielsituation-nachstellen

• Das funktioniert hoffentlich in der GUI? Wie kann man derzeit ein Replay laden? Bezieht sich das auf Replays aus dem Wettkampfsystem? Außerdem erste Nutzung der Abkürzung GUI. Sollte das nicht Spielleiter heißen? Dazu steht bisher nichts in Begriffe und Corporate Image https://www.notion.so/softwarechallenge/Begriffe-und-Corporate-Image-798185991f22459bb65e9002d6dd54a9

• Das scheint so nicht mehr möglich zu sein, richtig?

https://docs.software-challenge.de/grundlagen/server#automatische-spiele-der-testserver

• Spielsituation nachstellen existiert nicht
• Wurde das getestet, geht das noch?

https://docs.software-challenge.de/grundlagen/server#unerwartete-zugzeitberschreitungen-softtimeout

• Der Garbage Collector der Java Virtual Machine löst dieses Verhalten aus. Der Garbage Collector der Java Virtual Machine kann dieses Verhalten auslösen
• Andere Optionen als die im FAQ?

https://docs.software-challenge.de/grundlagen/server#massentests-mit-dem-testclient

• Wann TestClient?
• **Wichtig ist, dass nicht versucht wird, zwei Server auf dem selben Port zu starten. ** eventuell auch Fehlermeldung hinzufügen -> Bei folgender Fehlermeldung <fehler> wurden zwei Server auf dem selben Port gestartet.

https://docs.software-challenge.de/grundlagen/server#argumente-des-testclients

• Ich denke der Server sollte auch so eine Tabelle haben
• **Dieses Verhalten wird wahrscheinlich bald verändert, wobei dann jeder TestClient unabhängig vom Server die Punkte zählt. ** Hat sich dieses Verhalten geändert?

https://docs.software-challenge.de/grundlagen/contest#die-weboberflche

• https://contest.software-challenge.de

https://docs.software-challenge.de/grundlagen/contest#benachrichtigungen

• eE-Mail

https://docs.software-challenge.de/grundlagen/contest#computerspieler

• Sollte sich nichts finden, installieren wir gern etwas passendes nach. -> Hier fehlt eine Kontaktadresse
• **Hinweis: ... -> Hier sollte ein echtes Hinweis Feld genutzt werden.
• statt des bisherigen Clients

https://docs.software-challenge.de/grundlagen/contest#replays

• Im Vergleich zum Rest eher technisch

https://docs.software-challenge.de/spiele/26_piranhas/xml#felder

• TEAM_GRÖßE Warum ist dieses Feld deutsch? Aber soll das ein Feld mit dem Namen _<Größe> sein?

https://docs.software-challenge.de/entwicklung/#die-richtige-programmiersprache

• Swift Computerspieler noch aktuell, von 2020?
• https://github.com/jnccd/socha-client-csharp noch aktuell?

https://docs.software-challenge.de/entwicklung/kennenlernen#das-spiel-kennenlernen

• Die Spielregeln findet ihr hier Ich schlage vor den Satz zu löschen. Alternativ schlage ich folgende Formulierung vor: Außerdem sollte den Spielregel studiert werden.

  Da der Link dadurch spielabhängig wird, würde ich diese Seite gerne mit anderen zu einer Liste von Seiten die für ein neues Spiel angepasst werden hinzufügen. Dies könnte Teil der Readme oder eines Guides für eine neue Saison im Notion sein.

• Computerspieler nicht aktuell

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

• Anleitungen finden sich in der Readme des Repositories -> da steht nichts dazu
• Anleitungen finden sich in der Readme des Repositories und ergänzend dazu: Hier in der Dokumentation. der Anleitung zur Abgabe des Computerspielers.

https://docs.software-challenge.de/entwicklung/abgabe#python

• Eine Anleitungen dafür gibt es in der Dokumentation. -> Link nicht aktuell

https://docs.software-challenge.de/entwicklung/abgabe#inoffizielle-spielervorlagen

• Es gibt keine anderen Spielervorlagen? Manche Schulen machen Rust, eventuell stellen die was zur Verfügung?

https://docs.software-challenge.de/entwicklung/abgabe#generelles-zum-upload

• Das Hochladen des Spielers im Wettkampfsystem wird detailliert unter Wettkampfsystem->Computerspieler beschrieben. -> Da steht nichts dazu
• Java, Python, Ruby, Node.js, Swift, .NET, oft in mehreren Versionen. -> Ich habe noch andere Versionen gesehen. Ich denke diese Liste sollten wir aktuell halten.

https://docs.software-challenge.de/entwicklung/abgabe#andere-programmiersprache

• Überschrift: Andere Programmiersprachen
• GNU Getopt Konventionen -> Link veraltet
• Mit chmod +x wird die Binärdatei ausführbar gemacht. Dies ist nötig, da in einem ZIP-Archiv das Ausführbar-Attribut nicht gespeichert wird).

https://docs.software-challenge.de/entwicklung/abgabe#die-begegnungen

• ​ Dabei gilt für die Rechenzeit die im Institut verwendete obige Hardware als Referenz -> Institut wird die ganze Zeit schon nicht mehr erwähnt.

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

• Hinweis: Bevor man sich um die Einrichtung der Entwicklungsumgebung kümmert, muss unbedingt Java installiert sein. -> Echtes Hinweisfeld

• Spielervorlage herunterladen (von unserer Website unter allgemeine Dokumentation) -> Link einfügen

• 4. -> Bild unter 4. packen. Das Bild oben ist veraltet und markiert das falsche. Hier sollte Existing Gradle Project markiert sein.
• 5. Nun wählt man unter "Project root directory" die extrahierte Datei -> man wählt keine Datei sondern den Ordner aus

• Screenshots zum einbinden in die Anleitung

https://docs.software-challenge.de/entwicklung/java/einrichtung-der-entwicklungsumgebung#spielervorlage-aus-eclipse-starten

• Starten funktioniert nur, wenn die Gui oder ein Testserver schon auf einen Client wartet

[soerendomroes]

Ich bin noch nicht ganz durch, aber den Rest probiere ich auch noch aus / lese ich durch.

[soerendomroes]

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

Es ist durchaus valide auch unter nicht-Windows Systemen den Eclipse-Installer zu benutzen. Das ist vor allem interessant, da man auf den wenigsten Schul-Rechnern root Rechte hat.

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

"CONFIGURE SUCCESFUL" -> "CONFIGURE SUCCESSFUL"

[YoEnte]

/wettbewerb:

• Anmerkungen müssen meines Erachtens alle geändert werden

/wettbewerb#teilnahmebedingungen-und-registrierung

• max 3 Teams fänd ich fair tbh
• genau
• weiß nicht was offiziell gilt, wird auf jeden Fall nicht beachtet (wir hatten auch 3 Teams aus dem Profil damals)
• jep...
• muss UNBEDINGT geändert werden, auch auf Website
• jep

[...]

/grundlagen/player#der-computerspieler

• die Änderung zum Text ist sinnvoll

/grundlagen/server#der-spielleiter-server

• generell mehr Konsistenz in den Begriffen (die müssen auch intern geklärt werden und dann durch gezogen werden) Im Prinzip wie wissenschaftliche Prämissen und Definitionen

/grundlagen/server#spielsituation-nachstellen

• Replay laden funktioniert in der GUI!
• Aber gemeint ist (denke ich) an einem bestimmten Point of Time in einem Replay den Computerspieler neu weiterspielen zu lassen, damit der ggf anders auf die situation reagiert (wünsche ich mir schon lange .-. )
• korrekt, wär ein mega feature in der Zukunft

/grundlagen/server#automatische-spiele-der-testserver

• idk

/grundlagen/server#unerwartete-zugzeitberschreitungen-softtimeout

• gute idee und mehr kann ich zum gc in java nicht sagen

/grundlagen/server#massentests-mit-dem-testclient

• Gibt es (glaube ich) das ist ja ein admin host, der zwei spieler immer wieder spielen lässt, das war das Programm was Thomas und ich angesprochen haben, was nur in einem (hässlichen) CLI funktioniert und schwer auf windows zu starten war und somit für schüler unbrauchbar - sollte wie damals mal in der normalen GUI implementiert sein

/grundlagen/server#argumente-des-testclients

• ja, gab mir immer vor allem Verwirrung mit dem TestClient

[...]

/spiele/26_piranhas/xml#felder

• ja und guter Vorschlag um das zu verdeutlichen

/entwicklung/#die-richtige-programmiersprache

• nope und nope

/entwicklung/kennenlernen#das-spiel-kennenlernen

• ja

/entwicklung/abgabe#java

• Readme war mir so, idk was ich halluziniert habe und die Formulierung war mal so...

/entwicklung/abgabe#inoffizielle-spielervorlagen

• NOCH nicht, ein Schüler der KGS NMS macht gerade eine rust vorlage: https://github.com/simoncreates/socha sieht gut aus finde ich, will er als cargo package veröffentlichen, ich werde mich wahrscheinlich auch an der orientieren für einen full rust client (Credit where credit is due natürlich)

/entwicklung/abgabe#generelles-zum-upload

• ja, und wir brauchen py 3.14, Teams fragen danach (nächste Saison zusammen mit neuem Client)

[...] ja

/entwicklung/java/einrichtung-der-entwicklungsumgebung#einrichtung-der-javaentwicklungsumgebung
und weiter java

• nicht meins

Einmal meinen Senf zu der Geschichte

[soerendomroes]

@xeruf

https://docs.software-challenge.de/entwicklung/#die-richtige-programmiersprache
Swift Computerspieler noch aktuell, von 2020?
https://github.com/jnccd/socha-client-csharp noch aktuell?

Hat sich an der XML Schnittstelle etwas geändert? Falls ja, würde ich die Links rausnehmen.

[xeruf]

@YoEnte bitte die alten spielervorlagen links rausnehmen und den XML-link ersetzen durch https://docs.software-challenge.de/spiele/aktuell/xml

[xeruf]

und der JAva-link sollte aufs repo führen, da man im code des spielers nichts zum XML findet
https://github.com/software-challenge/backend

[YoEnte]

@xeruf welche alten spielervorlagen meinst du denn? Es gibt keine inoffiziellen mehr in den Docs, die verlinkt sind, ich kann höchstens die neue für rust hinzufügen, genau so die frage ist welchen Java-Link meinst du?
Verweise wären top

[YoEnte]

@soerendomroes und ich haben ja jetzt PRs geöffnet, wäre wohl sinnvoll dass die mal durchgehen und man dann abhakt, was gemacht wurde.