Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

Mention `^js` annotation in Externs Guide

Ouverte
#260 3 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
45/100
Type d'issue
Documentation
Clarté
Plutôt claire
Activité
À l'abandon
Stack technique
javascript
Domaine
documentation

Piste de recherche

Commencez par la section « externs inference » du externs guide, en particulier sa présentation des annotations ^js/Foo.Bar. Vérifiez comment l’annotation ^js, plus simple, est décrite et si elle devrait être la recommandation par défaut ; le travail est considéré comme terminé lorsque le guide documente clairement la forme prise en charge et la recommandation.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

major

The externs guide mentions type annotations like ^js/Foo.Bar.

Although it doesn't mention it, it's also possible to simply use ^js. (In fact anything like ^js/asdf will work, too.)

Should ^js be the default recommendation? Oftentimes you don't know the correct type of JS objects you're getting back from an NPM lib. Even if you do, using a generic annotation seems to have the same effect, so not sure there are any downsides to simply using ^js everywhere.

Langage dominant
Shell
Étoiles
107
Forks
130
Métriques de merge des PR
Aucune PR mergée en 30 j

Préparer son environnement

Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de clojure/clojurescript-site

Toutes les issues de clojure/clojurescript-site

Issues similaires

Plus d'issues Shell/Bash

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.