Improve local development instructions in the tutorial
還沒有人認領這個 Issue。
- 主要語言
- JavaScript
- 星號
- 11.8k
- 分支
- 7.9k
- 平均合併
- 1 天 11 小時
- 30 天內合併 PR
- 11
描述
I'm trying to get started with the easiest example from the tutorial at https://reactjs.org/tutorial/tutorial.html#setup-for-the-tutorial for some hours now. I desperately looking for the location where to put the ShoppingList, Square`, etc. classes. I invested some time in understanding the terms, but it always falls back to the contradiction in the instructions
Delete all files in the src/ folder of the new project
and
Note:
Don’t delete the entire src folder, just the original source files inside it. We’ll replace the default source files with examples for this project in the next step.
This is the same as
Delete the original source files in
src.
right (where the attribute original is still unclear because all files are original after creating the app with npx)? If not, I'm not getting it after reading it the fifth time.
Furthermore, I don't find any instructions where to put the code in the tutorial. My only guess is src/index.js, but that doesn't lead to the code being displayed after npm start.
I think that creating the app with content and then deleting it is a worse approach than build the application from scratch. Unfortunately, dependencies and tools like package managers seem to be already designed more as soon-to-be outdated rather than doing one good job for a long time in the "frontend world" - which is why most other tutorials on React going the way to build from scratch are outdated these days. The solution for this problem would be to simply put the tutorial commands in a CI script and test them periodically.
貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
研究方向
從連結 URL 中教學的「Setup for the Tutorial」區段開始,將有關刪除 src 中檔案的說明與後面的程式碼範例進行比較。驗證文件中 ShoppingList 和 Square 的放置位置以及 npm start 流程;當一個新的應用程式能夠按照說明操作,並在無需猜測的情況下顯示教學程式碼時,這項工作就完成了。
由索引模型根據 Issue 內容生成。
評估
- 技術堆疊
- javascript, react
- 領域
- documentation
- Issue 類型
- 文件
- 難度
- 2/5
- 預估耗時
- 1-3 小時
- 活躍度
- 停滯
- 描述清晰度
- 基本清楚
- 新手友好度
- 42/100