doc: add detailed doc for enum descriptions.

[louisunlimited]

Adds some doc on usage with adding enum help texts. I also asked claude to add some helpful tips in there, but can remove them if it's too much.

• Fixes Add an example on how to provide additional help for each item in an enum #816

Checklist

• I've added at least one test that validates that my change is working, if appropriate
• I've followed the code style of the rest of the project
• I've read the Contribution Guidelines
• I've updated the documentation if necessary

[rauhul]

lets cut this section

[louisunlimited]

Yes!

[rauhul]

can we use just one enum throughout this documentation, I think output format is a good example

[bhab20476-prog]

ميه ميه اوكي في السبت، ٤ أكتوبر ٢٠٢٥ ٧:٥٧ ص Rauhul Varma ***@***.***> كتب:

…

***@***.**** commented on this pull request. ------------------------------ In Sources/ArgumentParser/Documentation.docc/Articles/CustomizingHelp.md <#825 (comment)> : > @@ -150,6 +150,150 @@ OPTIONS: For an ``ExpressibleByArgument`` and `CaseIterable` type with many cases, you may still want to implement ``ExpressibleByArgument/allValueStrings`` to avoid an overly long list of values appearing in the help screen. For these types it is recommended to include the most common possible values. +## Providing Descriptions for Individual Enum Values + +When your argument or option uses an enum type, you can provide detailed descriptions for each enum value that will appear in the help screen. This is especially useful when the enum cases represent complex concepts that benefit from explanation. + +### Basic Enum Value Descriptions can we use just one enum throughout this documentation, I think output format is a good example — Reply to this email directly, view it on GitHub <#825 (review)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BYB4MMVHG5KRUXLOLUY6JGT3V5HR3AVCNFSM6AAAAACIIHOZMSVHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHMZTGMBRGU3TQMRXHE> . You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[louisunlimited]

Implemented feedback, lmk what else I can do!

[bhab20476-prog]

Haha, thanks! هاي في السبت، ٤ أكتوبر ٢٠٢٥ ١١:٠٠ م Louis Qian ***@***.***> كتب:

…

*louisunlimited* left a comment (apple/swift-argument-parser#825) <#825 (comment)> Implemented feedback, lmk what else I can do! — Reply to this email directly, view it on GitHub <#825 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BYB4MMTGFPRDYFBG5YN576L3WARO7AVCNFSM6AAAAACIIHOZMSVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTGNRYGUYDOMJSGY> . You are receiving this because you commented.Message ID: ***@***.***>