reactjs / reactjs/react.dev

Move Suspense introduction to the main docs repo

Abierto
#4,601 0 comentarios 1 reacción 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Lenguaje dominante
JavaScript
Estrellas
11.8k
Forks
7.9k
Merge medio
1 d 11 h
PR fusionados (30 d)
11

Descripción

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.

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Empieza leyendo el RFC de Suspense enlazado y la documentación eliminada de Concurrent Mode a la que se hace referencia en el issue; después, inspecciona cómo la documentación principal enlaza con ellos y dónde están configuradas las redirecciones. Determina si el RFC puede adaptarse como documentación traducible en el repositorio principal y si sigue siendo apropiado restaurar las páginas antiguas; se considerará terminado cuando la introducción acordada y el comportamiento de las redirecciones estén disponibles para los traductores.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
javascript, react
Área
documentation, localization
Tipo de issue
Documentación
Dificultad
4/5
Tiempo estimado
3-5 días
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
35/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.