You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I'll try to explain my reasoning for why a human-readable doc is better than a bash script in this case.
For starters, we end up installing things without really informing the user, running sudo. I think this is pretty bad practice, and I know it's been raised before as something to consider. I also think it's just generally better to have users install their own dependencies instead of running a bunch of commands for them. We of course can provide said commands, but running the commands automatically in their native environment to install system packages has always felt a bit intrusive to me.
Also, as we see in cases like these, if the feedback we expect doesn't exactly match what the bash script checks, the script just totally gives up or fails. Whereas a human-readable doc might lead someone to the correct solution.
In both cases, insufficiencies in the script/doc would lead people to ask for help and then we'd fix said script or doc. What's nice about the doc, though, is that it allows us to easier add notes and caveats that someone might care about instead of littering the shell script with logic and/or print-outs that will be drowned out by the other output from commands.
I guess you could ask "why not both?" and to that I'd say that maintaining two things is even worse than one. So I'd really prefer not to do that, but I acknowledge it'd be the best of both worlds...just at the expense of 2x the maintenance work.
After #1055 is merged, install.sh will only contain external (system) dependencies, at which point it can be replaced with a guide that can help people obtain the required dependencies for the project.
The text was updated successfully, but these errors were encountered:
To quote me in #1051 :
After #1055 is merged, install.sh will only contain external (system) dependencies, at which point it can be replaced with a guide that can help people obtain the required dependencies for the project.
The text was updated successfully, but these errors were encountered: