reactjs / reactjs/react.dev

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

Ouverte
#5,227 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Langage dominant
JavaScript
Étoiles
11.8k
Forks
7.9k
Merge moyen
1 j 11 h
PR mergées (30 j)
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!

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Ouvrez le React Tutorial à l’adresse https://reactjs.org/tutorial/tutorial.html et examinez sa première ligne. Mettez à jour la description afin qu’elle identifie le projet comme un jeu basé sur navigateur, puis vérifiez que la formulation est claire et que la page du tutoriel s’affiche toujours correctement.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
react
Domaine
documentation
Type d'issue
Documentation
Difficulté
1/5
Temps estimé
Moins d'une heure
Activité
À l'abandon
Clarté
Clairement spécifiée
Accessibilité débutants
55/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.