reactjs / reactjs/react.dev

Suspense feature description ambiguity between release note and React API reference

Offen
#4,829 0 Kommentare 1 Reaktion 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Vorherrschende Sprache
JavaScript
Sterne
11.8k
Forks
7.9k
Ø Merge
1 T. 11 Std.
Gemergte PRs (30 T.)
11

Beschreibung

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?

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

Vergleiche die React API-Referenz unter reactjs.org/docs/react-api.html mit dem Abschnitt über Suspense in Daten-Frameworks auf der React-18-Release-Seite. Prüfe, ob die API-Referenz und ihr Link zur React-16-Roadmap die unterstützten Anwendungsfälle korrekt beschreiben, aktualisiere dann die widersprüchliche Formulierung und stelle sicher, dass beide Seiten weiterhin konsistent sind.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
javascript, react
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
38/100

Neue Issues direkt in Ihr Postfach

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