-
Notifications
You must be signed in to change notification settings - Fork 29.8k
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
doc: clarify Boxstarter behavior on install tools #24000
doc: clarify Boxstarter behavior on install tools #24000
Conversation
Clarify the behavior of what Boxstarter may do when it runs on a box to install all the necessary tools so that there are no surprises to the end user when the script is run. Currently there is no interface that warns the user that Boxstarter will reboot the machine possibly multiple times depending on how many dependencies need to be installed and doesn't mention a need to disable UAC. For folks who see what may look like a reboot loop, we feel it is necessary to make them aware that UAC will be disabled and they will need to take action to re-enable UAC manually if they interfere/stop the script from finishing.
cls | ||
echo !!!!!WARNING!!!!! | ||
echo ----------------- | ||
echo Use of Boxstarter may reboot your box automatically multiple times. When |
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.
Nit-picking a bit, but "reboot your box" is rather colloquial. "reboot your computer" or something like that is probably preferable.
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.
Sounds good to me!
echo !!!!!WARNING!!!!! | ||
echo ----------------- | ||
echo Use of Boxstarter may reboot your box automatically multiple times. When | ||
echo performing a reboot, Boxstarter will need to disable UAC to allow the |
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.
Is it worth it to spell out what UAC refers to? Or are most Windows users going to know?
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.
As a developer using Windows, I guess you should know what it means. Looks much better now.
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 see this was fixed up by @joaocgreis
Thanks for opening this PR! I included this in #23987 as discussed there. |
Closed in favor of including this with #23987. |
Clarify the behavior of what Boxstarter may do when it runs on a box
to install all the necessary tools so that there are no surprises to
the end user when the script is run.
Currently there is no interface that warns the user that Boxstarter will
reboot the machine possibly multiple times depending on how many
dependencies need to be installed and doesn't mention a need to disable
UAC. For folks who see what may look like a reboot loop, we feel it is
necessary to make them aware that UAC will be disabled and they will need
to take action to re-enable UAC manually if they interfere/stop the script
from finishing.
Checklist
References #23838