rescript-lang/rescript-lang.org

Document co / contravariance (`<+a>`, `<-a>`)

Offen

#149 geöffnet am 01.01.2021

Auf GitHub ansehenContributor Guide
 (3 Kommentare) (2 Reaktionen) (0 zugewiesene Personen)MDX (258 Forks)github user discovery
help wantedmanual

Repository-Metriken

Stars
 (1.855 Sterne)
PR-Merge-Metriken
 (Keine gemergten PRs in 30 T)

Beschreibung

This one is definitely an advanced topic.

  • What does + and - mean?
  • What syntax constructs are possible? (type, function, etc.)
  • What practical use-cases does it have / Why do we need it?

Things to avoid:

  • Complex / too scientific wording
  • Too generic examples without practical context

Hints:

  • We use a covariant type in Js.Promise.t (see it here)

Contributor Guide

Research-Richtung
Schreiben Sie klare, nicht wissenschaftliche Erklärungen von Kovarianz und Kontravarianz anhand praktischer Beispiele wie Js.Promise.t. Vermeiden Sie komplexe Fachbegriffe und geben Sie Syntaxkonstrukte und Anwendungsfälle an.
Tech Stack
Keine
Domain
developer experience
Issue Type
Dokumentation
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
4
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-2 Tage
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
Keine
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
20