Skip to content

Simplify Installation Instructions for Better Onboarding Experience ( Documentation / Installation ) #10673

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
duyaan opened this issue Apr 16, 2025 · 2 comments · May be fixed by #10674
Open

Comments

@duyaan
Copy link

duyaan commented Apr 16, 2025

Is your feature request related to a problem? Please describe.
Yes. The current installation instructions in the documentation only show how to install react-admin via npm or yarn, which can be confusing or lead to issues for students or beginners. I personally faced difficulties using that method, and it's not the most straightforward approach for someone trying to get the project running quickly.

Describe the solution you'd like
I’d like to update the documentation and the CONTRIBUTING.md file to include an easier and faster installation method. This method works smoothly and avoids the problems I encountered using the existing instructions. The proposed steps are:

git clone
yarn install
cd react-admin
yarn run-simple

This approach is more accessible for new contributors and ensures the project is set up correctly with fewer steps and complications.

Describe alternatives you've considered

°Keeping the current installation instructions, but they may continue to cause confusion for beginners.
°Adding a troubleshooting section instead, but that doesn’t simplify the process as much as updating the steps directly.

Additional context
This change would make the onboarding process much smoother for students or new contributors. I can provide a pull request to add this to both the main documentation and the CONTRIBUTING.md file if needed.

@fzaninotto
Copy link
Member

Can you please explain what you're trying to do:

  1. clone the repo and install its dependencies to start hacking it, in order to improve the framework
  2. create a new React application built around react-admin
  3. add react-admin to an existing project

@duyaan
Copy link
Author

duyaan commented Apr 16, 2025

Thanks for the clarification! I’m actually cloning the repo to run it locally and contribute to the framework.
I noticed that while the setup method using yarn install and yarn run-simple is already mentioned somewhere in the project, it's not highlighted in the main installation section or in the CONTRIBUTING.md. As a beginner myself, I had to dig around a bit to find it, and that slowed me down.
I’d love to make a small contribution to surface that method earlier—maybe in the README or right at the top of the contributing guide—so new contributors can get started faster without confusion.
I think this small improvement could go a long way in making onboarding easier and more welcoming for first-time contributors.

@fzaninotto fzaninotto linked a pull request Apr 16, 2025 that will close this issue
4 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging a pull request may close this issue.

2 participants