reactjs / reactjs/react.dev

Suggestion: Update tutorial to say "browser-based game" instead of just "game".

Open
#5,227 1 comment 0 reactions 0 assignees View on GitHub

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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.