rescript-lang/rescript-lang.org

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

Ouverte

#149 ouverte le 1 janv. 2021

Voir sur GitHubGuide contributeur
 (3 commentaires) (2 réactions) (0 personne assignée)MDX (258 forks)github user discovery
help wantedmanual

Métriques du dépôt

Stars
 (1 855 étoiles)
Métriques de merge PR
 (Aucune PR mergée en 30 j)

Description

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)

Guide contributeur

Direction de recherche
Rédigez des explications claires et non scientifiques de la covariance et de la contravariance en utilisant des exemples pratiques comme Js.Promise.t. Évitez le jargon complexe et fournissez des constructions syntaxiques et des cas d'utilisation.
Stack technique
Aucun
Domaine
developer experience
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
4
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-2 jours
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
Aucun
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
20