-
Notifications
You must be signed in to change notification settings - Fork 444
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
docs[troubleshooting]: add Windows specific troubleshooting section #1087
base: master
Are you sure you want to change the base?
Conversation
ab0a919
to
28225ae
Compare
28225ae
to
ebc9b61
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think these docs should be placed under the System Administration
section in the Tutorials page.
Doesn't Troubleshooting makes more sense as it's actually about solving Windows specific issues? Sys admin seems more like targeted towards people running production instances, but the target audience of this section are devs mainly. |
The troubleshooting section defines specific issues and how to resolve them. Since this is more of a generic guide on how to use Windows for development purposes, it doesn't make sense for it to be under troubleshooting unless we define a specific issue that occurs while working on Windows and provide a solution for that. There is already a guide in the sys admin section on how to run Tutor on Arm64 systems. A guide for how to run and develop on Windows should fit in there. |
Okay, I'll move it there. |
While Windows isn't officially supported, some users might want to run Tutor on Windows. This section provides some tips and tricks to help you troubleshoot common issues.
ebc9b61
to
2366fc1
Compare
Hi @devkhan, I tried to follow this tutorial and it works perfectly fine when using it through WSL2 as you mentioned. However, I was unable to get it working when running through Windows. Here are the steps I followed:
However, this would fail for me at the npm run build-dev step during the initialization process. It would throw multiple file/module not found errors likely related to symlinks as you have mentioned. I then tried this on Tutor 17.0.5 as that utilized paver scripts instead and that would fail for me as well with the same error. Can you let me know if I'm doing something wrong in this process? |
@devkhan Hi, can you follow up on comments left by Danyal, please? Thanks |
@Danyal-Faheem Apologies, I was busy with work for a while. Finally getting around to this. I just tried it again with the same steps, and it seems to work fine for me. Here's my setup:
Although, only the I'll do a clean setup and report back if I'm missing some key step in the process. Can you share the exact config if possible? Or I can reach out to you on Slack to fully understand the issue? |
Hi @devkhan. Yeah sure, we can discuss it further on the openedx slack. I'll ping you there. |
@devkhan Any updates on this PR? Thank you |
While Windows isn't officially supported, some users might want to run Tutor on Windows. This section provides some tips and tricks to help you troubleshoot common issues. These are from my personal experiences and struggle to get local development working on Windows.
This originated from a conversation on Slack with @kdmccormick.