-
Notifications
You must be signed in to change notification settings - Fork 36
Improve guidance for examples & testsΒ #78
Description
It took me a few tries to figure out how to run the Lua files in the examples directory. I think some adjustments could have avoided this. I wonder if other people had a similar experience or weren't able to figure it out outright. Here's what I learned by trial & error:
-
I needed to download the entire set of directories on GitHub, i.e.,
remodel-master. -
I needed a
tempdirectory inremodel-masterto avoid an error, such as the following.
Here are a few ideas that might help:
-
Explicitly explain in the README or somewhere else what a person should do to prepare their device to run the example scripts. For example, "To try the example scripts, download the entire repository to a location on your device, such as your C: drive."
-
Instruct the user to create an empty
tempdirectory or (if possible) include this directory in the repository so it doesn't need to be created. (Iftests/scripts.rsis designed to do this for the user, then explain what the user needs to do to run this file, e.g., install Rust, and how/when they should run it.) -
Adjust the error message(s) to provide additional detail. For example:
The system cannot find the path specified ("C:\remodel-master\temp\") -
A walk-through tutorial would also be nice-to-have, but it's understandable that the effort required to do this may not be available. Not yet anyway.
