corrode / corrode/course

Notes from first trial course @chaosdorf

Open
#7 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Rust
Stars
15
Forks
1
Avg merge
53m
Merged PRs (30d)
12

Description

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:
  • Quiz:
    • wird nicht im Web Angezeigt (#14)
    • Für Gruppen spielen: A, B, C, D für die Antworten anzeigen um besser drüber sprechen zu können (#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

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by splitting the feedback into separate issues for the course chapters, web interface, code editor, dashboard, and CLI. Use the named areas—Chapters 1–3, the dashboard, quiz, code editor, and cargo course submit—to locate the relevant work. Each resulting issue should define one change, its acceptance criteria, and the test or manual check that confirms it is done.

Written by the indexing model from the issue text.

Assessment

Tech stack
css, rust
Domain
cli, documentation, frontend
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.