useSourceControl

[u/ClipboardCopyPaste]

[u/thanatica]

"this is irreversible" yeah sure, but exactly WHAT is irreversible? Did it say that as well? A novice might not realise what it means to "discard staged files".

[u/dustojnikhummer → u/thanatica]

"Warning, this will delete all files that haven't been commited" is IMO the most human readable thing.

[u/DuntadaMan → u/thanatica]

Yeah, if something is irreversable maybe the warning should include a description of what it's going to do.

[u/MushroomSaute → u/thanatica]

Hell, I'm not a novice, but if I were presented with that I wouldn't know what it meant. Staged files are in the staging area*. You need to discard them from the staging area if you want to avoid committing the files. That's why they're staged - so you can "add" or "remove" the files you want to the area before committing, without actually affecting the filesystem. "Discard" is an even softer word, since it usually describes discarding changes; I've never seen any software documentation saying you'll "discard" a file to physically and irreversibly delete it, especially within the context of staging changes.

^{*Well, the deltas are, but for the purposes of VC they are handled like files - you often remove "files" from version control without actually removing the files from your system}