typelevel / typelevel/typelevel.github.com

"Onboarding" experience site for TL?

Offen
#595 2 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Vorherrschende Sprache
HTML
Sterne
42
Forks
115
Ø Merge
5 T. 5 Std.
Gemergte PRs (30 T.)
7

Beschreibung

Folks have observed that Unison has an excellent site for helping folks get started with the language, under https://share.unison-lang.org/

At least in principle, it would be great if we had something similar: some paint-by-numbers introductions that go beyond the current tutorials and ease the path of getting oneself started with TL projects.

This is a fairly tall order, not least because there are so many different kinds of potential TL projects: there's probably no one-size-fits-all starting points. But a few solid examples might be really helpful.

(Note that this isn't just a code-plus-text project: well-thought-out UX and information architecture are likely to also matter.)

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne damit, die aktuellen Tutorials und die Unison-Onboarding-Website unter https://share.unison-lang.org/ zu prüfen. Identifiziere eine kleine Auswahl repräsentativer Einführungen in TL-Projekte und skizziere die dafür erforderliche UX und Informationsarchitektur. Als erledigt gilt die Aufgabe, wenn das Projekt einen abgestimmten, konkreten Onboarding-Umfang statt nur eines allgemeinen Vorschlags hat.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
html
Bereich
design, documentation, web-dev
Issue-Typ
Feature
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Veraltet
Klarheit
Muss geklärt werden
Anfängerfreundlichkeit
25/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.