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 區段開始,並將其與提議的初學者流程進行比較。完成的標準是:概覽依序說明元件、生命週期和 render,使用建議的 Hello World 範例,並可選擇連結到 Thinking in React。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
javascript, react
領域
documentation
Issue 類型
文件
難度
5/5
預估耗時
一週以上
活躍度
停滯
描述清晰度
基本清楚
新手友好度
30/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。