Troubleshooting

[awdeorio]

Add a few troubleshooting items suggested in 3 issues.

Closes #204, closes #209, closes #231

[awdeorio]

@hardy-ethan I would value your feedback if you can take a look. You created some of the issues.

[github-actions]

The spec from this PR is available at https://preview.sesh.rs/previews/eecs280staff/tutorials/241/.

^{(Available until Wed Jan 21 2026.)}

[hardy-ethan]

sure!

…

On Fri, Dec 19, 2025 at 10:21 AM Andrew DeOrio ***@***.***> wrote: *awdeorio* left a comment (eecs280staff/tutorials#241) <#241 (comment)> @hardy-ethan <https://github.com/hardy-ethan> I would value your feedback if you can take a look. You created some of the issues. — Reply to this email directly, view it on GitHub <#241 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AYQTEUNRU5LBLXHWRJJI6CT4CQJW3AVCNFSM6AAAAACPRU5YF2VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTMNZVGQ3DSOBSGE> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[jamesjuett]

Left a typo fix commit and a few minor suggestions.

[hardy-ethan]

I'll reply to Prof. Juett's comments for the other two issues, but for here:

#204

I'm thinking that in the case where the user has VSCode installed in the Downloads folder, they probably had it installed from a previous class or project, and might not remember that it's in the Downloads folder. It might be easier for them to look for the error message that VSCode shows:

Cannot update while running on a read-only volume. The application is on a read-only volume. Please move the application and try again. If you're on macOS Sierra or later, you'll need to move the application out of the Downloads directory. This might mean the application was put on quarantine by macOS. See this link for more information.

Maybe like (remove, add)

Installed to Downloads Cannot update while running on a read-only volume

VSCode may think the system is read only and fail to update if it is installed in the Downloads folder.

Probably should've included that error text in my original issue...

[awdeorio]

Thanks for the feedback. I think I got it all. Take another look.

[hardy-ethan]

Thanks for the feedback. I think I got it all. Take another look.

For #204 I only put the bolding to show that it was an addition, but if you think it looks good in the text feel free to keep 😂

Planning on testing the two other issues on a Windows install if I can get one running

[jkloosterman]

Not able to test myself but looks reasonable

[jamesjuett]

LGTM.

[hardy-ethan]

Tested on a fresh Windows VM:

#209 works fine with and without the WSL distro running
#231 the wsl --install command blocks CTRL + C at this phase. Closing the terminal window works, so we could tell the students to do that instead

[awdeorio]

the wsl --install command blocks CTRL + C at this phase. Closing the terminal window works, so we could tell the students to do that instead

Done! Thanks for testing this. 1bebad3