Description
Hi. Thanks for your work. I want to try out ReScript and have followed the installation instructions provided here.
Post-Installation Guidance:
After installation, the page mentions making a build or starting a watcher. However, there are no clear next steps provided, such as a quickstart guide. This makes it difficult to know what to do next without having to browse the entire documentation.
Project Initialization Confusion:
The difference between starting a project with npm create rescript-app@latest and installing npm install @rescript/react is not clear. The first command already creates the @rescript/react dependency in the rescript.json file, but this is not explained. The rescript.json file is mentioned without any explanation of its purpose or contents.
Suggestions for Improvement:
- Include a clear quickstart guide after the installation steps.
- Clarify the differences between npm create rescript-app@latest and npm install @rescript/react.
- Provide an explanation of the rescript.json file and its role in a ReScript project.
- Consider revising the documentation to be more beginner-friendly and not assume prior knowledge of the JavaScript ecosystem.
Thank you for considering these improvements.