reactjs / reactjs/react.dev

🚫** (Warns in development) is open to interpretation

Aberta
#2,701 0 comentários 0 reações 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

My colleagues and I were discussing this section of the docs and got a bit confused:

https://reactjs.org/docs/concurrent-mode-adoption.html#feature-comparison

Screenshot 2020-01-23 at 12 28 05

It was not 100% clear whether 🚫** → Warns in development means

  • works, may be buggy, warns in development
    or
  • does not work, also warns in development.

Both interpretations can be explained logically. The first one can be true because the footer note does explicitly say does not work and we're still in 16.x, which assumes no breaking changs. The second interpretation comes from the presence of 🚫.

I'm wondering if the docs could be improved by replacing 🚫* and 🚫** with distinct emojis (e.g. ⚠️, ⛔️, 🚨, 🤞, ✳️, 🆗, ❇️, etc.). Each emoji can be present in a footnote, including ✅ and 🚫.

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

Comece pela seção Feature Comparison na URL vinculada concurrent-mode-adoption.html e inspecione a legenda, as notas de rodapé e a captura de tela de 🚫* e 🚫**. Esclareça a distinção entre o comportamento compatível, mas com aviso, e o comportamento não compatível; em seguida, verifique se os símbolos e as explicações revisados são exibidos claramente na documentação.

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
48/100

Receba novas issues na sua caixa de entrada

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