Doku verbessern

[LuckyLukert]

[Aus Manuels Übersichtsdokument übertragen]

Doku zur Installation des CMS zwecks Aufgabenentwicklung verbessern bzw. Installationsprozess vereinfachen (→ podman container)

• Unter https://contest.informatik-olympiade.de/docs/Installation.html#preparation-steps ist der Link falsch (bzw. eigentlich will man clonen, nicht ein Archiv runterladen)
• Grundlegende Systemanforderungen (Linux (bevorzugt Ubuntu oder Arch) bzw. WSL oder VM) und Speicherbedarf sollten wir dokumentieren.
  • Speicherbedarf wäre evtl. überhaupt erst noch zu testen?
• Sektion zu "Wie editiert man die docs?"
• Das Paket python3-dev fehlt als Abhängigkeit in der Doku (zumindest unter Mint, aber das betrifft wahrscheinlich auch Ubuntu)
• Wenn du bei
  pip3 install -r requirements.txt
  eine Fehlermeldung über bdist_wheel bekommst, solltest du
  pip3 install wheel
  ausführen und es erneut probieren
• Pakete, die unter Ubuntu 22.04 in der Doku fehlen:
  • libcups2-dev
  • libpq-dev
  • python3.9{,-dev,-venv} (wenn man python3.9 nehmen will. Dann sollte man auch aber auch bei der venv-Installation python3.9 statt python verwenden)
• Irgendwo (bei den Systemanforderungen?) sollte vermutlich auch die Möglichkeit erwähnt werden, den Docker-container zu nutzen
• isolate wird aktuell auf CGroups-v2 migriert; aktuell gibt es zwei nutzbare Varianten. Aktuell sollten im Idealfall beide dokumentiert werden. Langfristig wird vmtl nur noch v2 unterstützt (?)
• dokumentieren, dass das Scoreboard nur funktioniert, wenn nur ein einzelner Contest (nicht ALL) aktiv ist

[LuckyLukert]

Zu "wie editiert man die docs?" gibt es möglicherweise hier eine Anleitung: #22