reactjs / reactjs/react.dev

Suspense feature description ambiguity between release note and React API reference

Aberta
#4,829 0 comentários 1 reação 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Linguagem predominante
JavaScript
Estrelas
11.8k
Forks
7.9k
Merge médio
1d 11h
PRs com merge (30d)
11

Descrição

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?

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Direção de pesquisa

Compare a referência da API do React em reactjs.org/docs/react-api.html com a seção sobre Suspense em frameworks de dados da página de lançamento do React 18. Verifique se a referência da API e seu link para o roadmap do React 16 descrevem com precisão os casos de uso compatíveis; em seguida, atualize a redação conflitante e verifique se ambas as páginas continuam consistentes.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
javascript, react
Domínio
documentation
Tipo de issue
Documentação
Dificuldade
2/5
Tempo estimado
1-3 horas
Status de atividade
Estagnada
Clareza
Razoavelmente clara
Facilidade para iniciantes
38/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.