Notes from first trial course @chaosdorf

[M3t0r]

These are in German :-/

• Playground: "variable not used" -> wie kann ich die jetzt angucken?
• Playground: kein output (dbg!(), println!())
• Kapitel 1: Wie zeig ich das "300".parse::<u8>() nicht auf den maximalen wert clampt (ohne Results zu erklären)
• Kapitel 1: wie rufe ich eine Funktion auf?
• Kapitel 1: wie rufe ich u32::to_string() auf number auf? Das wird aus dem Text davor nicht klar (number.to_string() / u32::to_string(number))
• Hover über Links wechselt den Cursor nicht
• Als letzten Hinweis die Lösung anzeigen?
• Geld als float is sehr schlecht! Integer Cents? Andere Beispiele?
• Kapitel 1 Übung 2: Unklar dass das Ergebnis abgerundet werden soll. Erste Vermutung ist normales Runden -> 109 != 108
  • Erste erwähnte Funktion in der info box ist round, aber die soll garnicht verwendet werden...
• Indikator für die Hints das man die ausklappen kann (und dann auch wieder einklappen kann) (normales chevron von <details>)
• Kapitel 1: Statt Geld vlt Berechnungen mit Speicherkapazität?
  • Volumenprozent von Bier? Triggerwarnung?
  • Sauerteig Hydration?
• Cheatsheet ist kaputt
• Titel in Titlecase formatieren
• CSS für print fehlt
• Progress Counter geht erst hoch wenn man in das nächste Kapitel wechselt, nicht wenn man die letzte Übung submitted
  • HTMX Out-of-Bound Swap ("OOB")
• Kapitel 1: Funktionen in der "What we learned" Box verlinken
• Aufmerksamkeit halten ist schwierig mit den trockenen Typen im ersten Kapitel
  • Ausblick auf Bonbon später geben?
  • Überblick über alle Rust features schnell runter reißen damit man später wenn man auf sowas später trifft es schon mal gehört hat
  • Am Anfang: zeige ein kleines Program und erkläre die einzelnen Komponenten
    • Hier ist ein Datentyp
    • Das ist der Returnvalue
• Kapitel 2: &str und String layout als Popup reinmachen
• Kapitel 2: "Where to look things up" sollte ein callout werden
• Kapitel 2 Übung 2: text.len() gibt auch richtige Werte, keine langen codepoints wie https://emojipedia.org/transgender-flag#technical
  • café als Beispiel
• Kapitel 2: Button to show solution as final step in hints
• Oben rechts noch Knopf anzeigen wenn man Admin ist
• Submitted statt Submit. Wenn ich auf Run gedrückt habe, muss ich nochmal drauf drücken? Es passiert genau das gleiche
  • Autosubmit wenn alle tests grün sind
• Übungsauswahl Dropdown Menü in der Titelzeile flackert beim hovern
• Im Dashboard wird Kap 2 Übung 3 als 4_shout angezeigt
• Wenn man die Seite neu lädt, dann ist der Submit Status der einzelnen Übung nicht angezeigt
• Dashboard: Bei Recent Activities dropdown einen Filter einbauen
• Einen Knopf zum Repo einfügen (damit Leute wissen das man das auch offline ausführen kann)
• Kapitel 3: komische Phrase "next-and-a-half chapters away"
• Kapitel 3 Übung 1: Für die Tabelle muss man immer hoch scrollen, das die Tabelle nochmal als Prosa im Kommentar steht war nicht offensichtlich
  • Statt Tabelle was malen? Learn you a Haskell for Great Good
  • Die Tabelle soll zum Hint werden
• Kapitel 3 Übung 4: Endlosschleifen führen zu HTTP 502 und Did not compile.
• Kapitel 3 Übung 4: Kein Testfall der schief geht mit while remainder > 10, nicht >=
• Codeeditor:
  • Ligaturen ausschaltbar?
  • Mehr Optionen -> Dropdown Menü?
  • Scrolldown bei Run sollte nicht sowei scrollen das die Knopfzeile nicht mehr sichtbar ist
    • https://talks.utilitybend.com/css-state-machine/info
• Quiz:
  • wird nicht im Web Angezeigt (Embed the Rust Fundamentals Quiz inline on its chapter page #14)
  • Für Gruppen spielen: A, B, C, D für die Antworten anzeigen um besser drüber sprechen zu können (Embed the Rust Fundamentals Quiz inline on its chapter page #14)
  • Vlt 2 oder 3 Quizze zwischen den Kapitel verteilen, aber eigentlich als Abschluss schon OK
• Kapitelübersicht
  • Auf der Übersichtsseite nicht links nach rechts und dann zeile runter, sondern runter und dann die nächste spalte (anders rum als jetzt, so wie auf den Kapitelseiten)
  • Checkmark statt Punkt für abgeschlossene Kapitel
  • Hintergrund/Border um die Kapitel boxen damit der Punkt/Checkmark zu dem Kapitel zugehörig visualisiert wird. Auf der Startseite ist das verwirrend, in den Kapiteln mit den Balken optisch schnell verständlich.
  • Hinter die Kapitel schreiben ob es eine Lesson, ein Chapter, oder Exercise ist
• Team ist aufgeladen, group oder cohort überall verwenden
• "Putting it together" so früh wie möglich machen (zB vor "Traits")
• Exportfunktion für Code Schnipsel?
• Token für die CLI irgendwo auf der Website anzeigen
• Solutions von anderen Gruppenmitgliedern auf der Seite auffindbar machen (Gruppenname in der headerbar?)
• CLI tool auch cargo course submit 1 unterstützen, nicht nur die Datei

[mre]

Triage as a checklist (preserving the original wording and grouping). Tick items off as they land; bugs roughly first, then UX, then content/ideas.

Bugs

• Cheatsheet ist kaputt (Issue #7 batch A: cheatsheet layout + submit-state on reload #12)
• Quiz wird nicht im Web angezeigt
• Playground: "variable not used" -> wie kann ich die jetzt angucken?
• Playground: kein output (dbg!(), println!())
• Im Dashboard wird Kap 2 Übung 3 als 4_shout angezeigt (Issue #7 batch 2: chevron, GitHub link, autosubmit, integer cents, prettify labels #10)
• Wenn man die Seite neu lädt, ist der Submit-Status der einzelnen Übung nicht angezeigt (Issue #7 batch A: cheatsheet layout + submit-state on reload #12)
• Progress Counter geht erst hoch wenn man ins nächste Kapitel wechselt, nicht beim Submit der letzten Übung
• Kapitel 3 Übung 4: Endlosschleifen führen zu HTTP 502 und Did not compile.
• Kapitel 3 Übung 4: Kein Testfall der schief geht mit while remainder > 10, nicht >= (Easy wins from issue #7 #9)
• Übungsauswahl Dropdown-Menü in der Titelzeile flackert beim Hovern
• Hover über Links wechselt den Cursor nicht
• Scrolldown bei Run sollte nicht so weit scrollen, dass die Knopfzeile nicht mehr sichtbar ist
• Submitted statt Submit. Nach Run muss man nochmal drücken und es passiert das gleiche (Issue #7 batch 2: chevron, GitHub link, autosubmit, integer cents, prettify labels #10)
• Indikator für die Hints dass man die ausklappen/einklappen kann (chevron von <details>) (Issue #7 batch 2: chevron, GitHub link, autosubmit, integer cents, prettify labels #10)

UX / Produkt

• Als letzten Hinweis die Lösung anzeigen
• Kapitel 2: Button to show solution as final step in hints
• Autosubmit wenn alle Tests grün sind (Issue #7 batch 2: chevron, GitHub link, autosubmit, integer cents, prettify labels #10)
• Oben rechts Admin-Knopf anzeigen wenn man Admin ist
• Dashboard: Bei Recent Activities Dropdown einen Filter einbauen
• Knopf zum Repo einfügen (damit Leute wissen das man das auch offline ausführen kann) (Issue #7 batch 2: chevron, GitHub link, autosubmit, integer cents, prettify labels #10)
• Team ist aufgeladen, group oder cohort überall verwenden
• Token für die CLI irgendwo auf der Website anzeigen
• Solutions von anderen Gruppenmitgliedern auf der Seite auffindbar machen (Gruppenname in der headerbar?)
• CLI tool auch cargo course submit 1 unterstützen, nicht nur die Datei (decided against it)
• Exportfunktion für Code-Schnipsel (decided against it)

Kapitelübersicht

• Auf der Übersichtsseite runter und dann die nächste Spalte (so wie auf den Kapitelseiten)
• Checkmark statt Punkt für abgeschlossene Kapitel
• Hintergrund/Border um die Kapitel-Boxen damit der Punkt/Checkmark zum Kapitel zugehörig visualisiert wird
• Hinter die Kapitel schreiben ob es eine Lesson, ein Chapter oder Exercise ist (decided against it)

Codeeditor

• Ligaturen ausschaltbar
• Mehr Optionen -> Dropdown-Menü
• Referenz: https://talks.utilitybend.com/css-state-machine/info (looked into it and not worth it right now)

Sonstiges / Print

• Titel in Title Case formatieren
• CSS für print fehlt
• HTMX Out-of-Bound Swap ("OOB")

Kapitel 1 (Inhalt)

• Wie zeig ich das "300".parse::<u8>() nicht auf den maximalen Wert clampt (ohne Results zu erklären)
• Wie rufe ich eine Funktion auf?
• Wie rufe ich u32::to_string() auf number auf? (number.to_string() / u32::to_string(number))
• Geld als float ist sehr schlecht! Integer Cents? Andere Beispiele? (Issue #7 batch 2: chevron, GitHub link, autosubmit, integer cents, prettify labels #10)
• Übung 2: Unklar dass das Ergebnis abgerundet werden soll (109 != 108) (Issue #7 batch 2: chevron, GitHub link, autosubmit, integer cents, prettify labels #10)
• Erste erwähnte Funktion in der Info-Box ist round, aber die soll garnicht verwendet werden (Issue #7 batch 2: chevron, GitHub link, autosubmit, integer cents, prettify labels #10)
• Funktionen in der "What we learned"-Box verlinken
• Statt Geld vlt. Berechnungen mit Speicherkapazität?
• Volumenprozent von Bier? Triggerwarnung?
• Sauerteig-Hydration?
• Aufmerksamkeit halten ist schwierig mit den trockenen Typen im ersten Kapitel
• Ausblick auf Bonbon später geben
• Überblick über alle Rust-Features schnell runterreißen
• Am Anfang: zeige ein kleines Programm und erkläre die einzelnen Komponenten (Datentyp, Returnvalue, ...)

Kapitel 2 (Inhalt)

• &str und String Layout als Popup reinmachen
• "Where to look things up" sollte ein Callout werden
• Übung 2: text.len() gibt auch richtige Werte, keine langen Codepoints (z.B. Trans-Flag Emoji)
• café als Beispiel

Kapitel 3 (Inhalt)

• Komische Phrase "next-and-a-half chapters away" (Easy wins from issue #7 #9)
• Übung 1: Für die Tabelle muss man immer hoch scrollen; dass die Tabelle nochmal als Prosa im Kommentar steht war nicht offensichtlich
• Statt Tabelle was malen? (Learn You a Haskell for Great Good)
• Die Tabelle soll zum Hint werden

Quiz

• Für Gruppen-Spielen: A, B, C, D für die Antworten anzeigen
• Vlt 2 oder 3 Quizze zwischen den Kapiteln verteilen (aber als Abschluss auch OK)

Struktur / Pädagogik

• "Putting it together" so früh wie möglich machen (z.B. vor "Traits")

[mre]

Batch B follow-up: unified TOC (commit 58179e3 on fix/issue-7-batch-b)

The homepage and the per-chapter "All exercises" nav rendered two different TOCs — bordered cards on / vs. flat uppercase blue rows on /exercise/{slug} — backed by two copies of the markup and two CSS blocks. Collapsed to one:

• New templates/partials/chapter_list.html is the only source of TOC markup; both pages {% include %} it.
• Shared .chapter-list / .chapter-row styles moved into base.html.
• Dropped the homepage's bespoke .book-toc* CSS (~95 lines) and the "Chapter / Lesson / Quiz" pill (an earlier addition that was never on the chapter-page TOC).
• DashboardTemplate gained a dots: Vec<ProgressDot> field via a small dots_from_exercises helper so it feeds the partial the same shape render_exercise_page already builds.

Net: +196 / −269 across 5 files. Homepage and chapter pages now render byte-for-byte the same TOC.

[mre]

Merged in #13 (commit history kept atomic):

• 1b247d4 Title Case across chapter titles and cheatsheet
• 58179e3 Share one chapter-list partial between homepage and exercise pages
• 1a3c26f Clarify DashboardTemplate::dots doc comment

Closes from this issue:

• \u2705 Titel in Title Case formatieren
• \u2705 Homepage TOC inconsistent with per-chapter TOC (follow-up surfaced during batch B review)

[mre]

Quiz-Abschnitt teilweise erledigt via #14 (gemerged in 5554d19):

• ✅ wird nicht im Web angezeigt — Das Quiz rendert jetzt direkt im Kapitel-Flow (examples/21_rust_fundamentals_quiz/quiz.toml + serverseitiger Quiz::render_html), in der Farbpalette des Kurses, statt einer separat gestylten CDN-static/quiz.html.
• ✅ A, B, C, D für die Antworten anzeigen — Jede Antwort hat einen runden Marker mit A/B/C/D, generiert per CSS counter-increment, also auch nach dem Shuffle immer in der richtigen Reihenfolge.
• ⏭ 2 oder 3 Quizze zwischen den Kapitel verteilen — nicht angefasst (im Issue als "eigentlich als Abschluss schon OK" markiert). Die Infrastruktur trägt das aber jetzt: jedes Kapitel mit einem quiz.toml bekommt automatisch einen Step::Quiz ans Ende. Reichen würde, weitere quiz.toml-Dateien anzulegen.

Bonus, fiel beim Testen auf:

• Antworten werden bei jedem Render frisch geshuffelt (rand::seq::SliceRandom), damit die richtige Antwort nicht in 12 von 20 Fragen B ist.
• Nach einem Klick wird nur die Erklärung der gewählten Antwort gezeigt (plus die der richtigen, falls falsch geraten), statt aller vier auf einmal.