reactjs / reactjs/react.dev

Suspense feature description ambiguity between release note and React API reference

Ouverte
#4,829 0 commentaires 1 réaction 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Langage dominant
JavaScript
Étoiles
11.8k
Forks
7.9k
Merge moyen
1 j 11 h
PR mergées (30 j)
11

Description

On actual (v18.2.0) React API reference page (https://reactjs.org/docs/react-api.html) is written:

Today, lazy loading components is the only use case supported by <React.Suspense>:

and

In the future we plan to let Suspense handle more scenarios such as data fetching. You can read about this in our roadmap.

(also interesting that this link referring into React 16 Roadmap while we have 18 released.)

At the same time React 18 Release Page says that:

In React 18, you can start using Suspense for data fetching in opinionated frameworks like Relay, Next.js, Hydrogen, or Remix.

and looks like 'Suspense for data fetching' can be used and information in React API reference in outdated?

Guide de contribution

Ouvrir le guide de contribution

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.

Piste de recherche

Comparez la référence de l’API React sur reactjs.org/docs/react-api.html avec la section consacrée à Suspense dans les frameworks de données de la page de sortie de React 18. Vérifiez que la référence de l’API et son lien vers la feuille de route de React 16 décrivent correctement les cas d’utilisation pris en charge, puis mettez à jour la formulation contradictoire et vérifiez que les deux pages restent cohérentes.

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

Évaluation

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

Recevez les nouvelles issues par e-mail

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