Troubleshooting issues with installing Ruby on Windows

[juliastone0729]

To mitigate issues with installation, our team made a few updates to the Installing Ruby on Windows section of our documentation.

If you are installing Ruby on Windows and receive an error like "/c/Users/example/AppData/Local/Microsoft/WindowsApps/jekyll: line 6: /c/Users/example/AppData/Local/Microsoft/WindowsApps/ruby: No such file or directory" you can resolve the issue by following these steps:

1. Uninstall ruby using Settings > apps
2. After the uninstall finishes, go to C: drive, look for "Ruby32-x64" folder and delete it
3. Restart your computer
4. Fresh download the stable ruby, 3.2.2-1
5. Install it with the defaults (make sure “Add Ruby executables to your PATH” is checked)
6. Open git bash
7. Check to see if ruby installed by typing ruby -v (This should provide a response like “ruby 3.2.2” which lets you know that your Ruby is correctly installed)
8. Run the command gem update --system
9. Close terminal
10. Open git bash again
11. Run gem install bundler jekyll
12. Close terminal

Note: If you already had everything installed and working, the final step is that in your existing projects on your machine, you need to delete the "Gemfile.lock", since they were created by your old versions, then do a fresh bundle install.