reactjs / reactjs/react.dev

Intro to react for BEGINNERS revision

未关闭
#1,015 0 条评论 2 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

主要语言
JavaScript
星标
11.8k
派生
7.9k
平均合并
1 天 11 小时
30 天内合并 PR
11

描述

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.

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

调研方向

从链接的 React 教程的 Overview 部分开始,并将其与提议的初学者流程进行比较。完成的标准是:概览按组件、生命周期和渲染的顺序进行说明,使用建议的 Hello World 示例,并可选择链接到 Thinking in React。

由索引模型根据 Issue 内容生成。

评估

技术栈
javascript, react
领域
documentation
Issue 类型
文档
难度
5/5
预计耗时
一周以上
活跃度
停滞
描述清晰度
基本清楚
新手友好度
30/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。