docs(flag): add UseShortOptionHandling description

[BlackHole1]

What type of PR is this?

• documentation

What this PR does / why we need it:

Add a description of UseShortOptionHandling in the Flag section so that users can clearly understand that to support Flags like -vvv, it is necessary to set UseShortOptionHandling.

Which issue(s) this PR fixes:

Close: #1942

Special notes for your reviewer:

nil

Testing

nil

Release Notes

NONE

[Juneezee]

LGTM. However, the documentation website https://cli.urfave.org/ is still built using the docs folder of v2-maint branch so this change won't be reflected on the website.

@dearchap @meatballhat Should we consider moving the publish job from v2-maint branch to main branch?

cli/.github/workflows/cli.yml

Lines 71 to 88 in a4832fd

	publish:
	permissions:
	contents: write
	if: startswith(github.ref, 'refs/tags/')
	name: publish
	needs: [test-docs]
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4
	with:
	fetch-depth: 0
	- run: make ensure-mkdocs
	env:
	FLAGS: --upgrade-pip
	- run: make set-mkdocs-remote
	env:
	MKDOCS_REMOTE_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
	- run: make deploy-mkdocs

[abitrolly]

@junezee you mean this one?

cli/.github/workflows/test.yml

Lines 89 to 96 in 937cfe9

	publish:
	permissions:
	contents: write
	# TODO: switch once v3 is out of alpha {{
	# if: startswith(github.ref, 'refs/tags/')
	if: false
	# }}
	name: publish

[abitrolly]

I would say, docs publishing needs a separate job, which will pull markup files from all branches. This way v2 docs will be maintained in v2-maint branch.

[BlackHole1]

Should we consider moving the publish job from v2-maint branch to main branch?

This may not be a good idea because the current main branch contains the documentation for v3, which is still in the alpha stage. If we change it to the main branch, the website will display the v3 documentation.

I think we can merge this PR first, as the current changes include docs/v3. I can submit another PR and point it to the v2-maint branch :)

[bartekpacia]

Thanks for contributing! 🎉