Skip to content

Conversation

@waldyrious
Copy link
Member

@waldyrious waldyrious commented Nov 14, 2025

Checklist

  • The page(s) are in the correct platform directories: common, linux, osx, windows, sunos, android, etc.
  • The page description(s) have links to documentation or a homepage.
  • The page(s) follow the content guidelines.
  • The page(s) follow the style guide.
  • The PR contains at most 5 new pages.
  • The PR is authored by me, or has been human-reviewed if it was created with AI or machine translation software.
  • The PR title conforms to the recommended templates.
  • Version of the command being documented (if known):

Reference issue: #

@github-actions github-actions bot added page edit Changes to an existing page(s). review needed Prioritized PRs marked for reviews from maintainers. labels Nov 14, 2025
`git clean {{[-n|--dry-run]}}`

- Forcefully delete untracked files:
- Immediately force deletion of all untracked files:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Immediately force deletion of all untracked files:
- Delete all untracked files without prompting:

I felt like the wording was off.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think that may be misleading: the -f option does not control prompting (the -i does); instead, it's a way to confirm your decision to go ahead with an irreversible change — similar to how you need to pass -f to rm a directory, regardless of whether you use -i or not.

Besides, I think it's important to keep the "force" word in the description, to help readers create the mental association with the -f option name.

(That said, I certainly agree that this command has an awkward UX, and would welcome alternative suggestions that might make the wording feel less off, as long as they don't conflict with the above points).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

page edit Changes to an existing page(s). review needed Prioritized PRs marked for reviews from maintainers.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants