reactjs / reactjs/react.dev

Intro to react for BEGINNERS revision

Aberta
#1,015 0 comentários 2 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

An exchange of tweets with super friendly @gaearon lead me to convert one of my replies into this ticket. To improve what is on the overview section for beginners here: https://reactjs.org/tutorial/tutorial.html

screen shot 2018-06-28 at 01 58 36

I suggest the "Overview" section is dedicated to the following and flows like this:

  • Explain what a component is (type, class) and that ES6 syntax which for someone with little JS experience looks like a normal JS syntax but it is not. With that hint outline what each term mean.

screen shot 2018-06-28 at 02 11 43

  • Explain a component's lifecycle briefly before touching on render and constructor methods. I think React lifecycle is inspired/affected by iOS/Android lifecycles so why not touch on those, for people like me who came from mobile world. Learning by association is one of the learning methods (I think).

  • Now feel free to explain what render is and why it must return something (including null).

  • Now is time to show Hello World not a shopping list:

class HelloWorld extends React.Component {
  render() { //compulsory React method/fucntion
    return (
      <p className="cssclass"> // a <p> element is also a component, className is a property
         Hello World!
      </p>
    );
  }
} 
  • (Optional) link to Thinking in React early on and that coloured component hierarchy of the stock list.

screen shot 2018-06-28 at 02 11 43

Its not easy to think like a beginner once you are a pro. Hope this is an improvement suggestion and not a cause for confusion.

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 Overview do tutorial de React vinculado e compare-a com o fluxo proposto para iniciantes. A tarefa estará concluída quando a visão geral explicar componentes, ciclo de vida e renderização nessa ordem, usar o exemplo Hello World sugerido e opcionalmente incluir um link para Thinking in React.

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
5/5
Tempo estimado
Mais de uma semana
Status de atividade
Estagnada
Clareza
Razoavelmente clara
Facilidade para iniciantes
30/100

Receba novas issues na sua caixa de entrada

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