reactjs / reactjs/react.dev

Move Suspense introduction to the main docs repo

Aperta
#4,601 0 commenti 1 reazione 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Lingua principale
JavaScript
Stelle
11.8k
Fork
7.9k
Merge medio
1g 11h
PR unite (30g)
11

Descrizione

I asked for this before, but the official docs should not lightly link to external articles to explain basic React concepts, because external articles cannot be translated.

Currently, this external RFC, available only in English, is somehow treated as the "official get-started guide" for Suspense, useTransition, etc. It is linked from many pages in the main docs, including recent blog articles. On the other hand, information in the current docs is limited, and they do not explain a Suspense forms a "catch block (boundary)", for example. It's hard for non-English speakers to understand how to use the new concurrent features now.

The React team even deleted the old Concurrent Mode docs without providing alternative articles, which means the most comprehensible introduction for Suspense is now lost at least in my language. I understand they were outdated, but they were better than nothing. The removed files are redirected to 17.reactjs.org, but 17. is not available in other languages.

Please consider the following:

  1. Copy the contents of the RFC to somewhere in the main docs so that translators can work on them.
  2. Meanwhile, restore the Concurrent Mode docs and revert the redirects so that non-English speakers can read them again. It's fine to warn they are severely outdated, but there is no reason to make them completely unavailable in other languages.

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Inizia leggendo il RFC di Suspense collegato e la documentazione rimossa di Concurrent Mode a cui si fa riferimento nell’issue, quindi esamina come la documentazione principale vi rimanda e dove sono configurati i reindirizzamenti. Determina se il RFC può essere adattato in documentazione traducibile nel repository principale e se sia ancora appropriato ripristinare le vecchie pagine; il lavoro sarà considerato completato quando l’introduzione concordata e il comportamento dei reindirizzamenti saranno disponibili per i traduttori.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
javascript, react
Ambito
documentation, localization
Tipo di issue
Documentazione
Difficoltà
4/5
Tempo stimato
3-5 giorni
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.