Suggestion: Update tutorial to say "browser-based game" instead of just "game".
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 11.8k
- Forks
- 7.9k
- Avg merge
- 1d 11h
- Merged PRs (30d)
- 11
Description
For the React Tutorial https://reactjs.org/tutorial/tutorial.html
The first line currently reads:
"We will build a small game during this tutorial."
It may be more clear (and helpful) if it were to read:
"We will build a small browser-based game during this tutorial."
One of my initial reasons for avoiding React was actually due to this line. When I read it, I assumed that the game would be a desktop game. Whereas I understood using a basic game to teach the fundamentals of React, I had no interest in learning a framework that was built for the desktop first and the browser second.
This was a massive misunderstanding for me, but I'm sure I'm not the only one.
This tutorial is the first point of entry into learning React, so it may be helpful to at least clarify that the tutorial is a browser-based game. Then I (and others) would be less turned off by the idea of learning React via a game rather than via a more traditional blog or web app tutorial.
I appreciate your consideration. And thank you for such a great framework!
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Open the React Tutorial at https://reactjs.org/tutorial/tutorial.html and review its first line. Update the description so it identifies the project as a browser-based game, then verify that the wording is clear and the tutorial page still renders correctly.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- react
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 55/100