Traditional UNIX®️ options for help are -? and -h. --long-options are a horrid GNU-ism and shunned by clean UNIX®️ compliant programs, because such programs come with detailed, professionally written manual pages which contain extensive SYNOPSIS and EXAMPLES sections.
Implementing --long-options makes the poor users type much more, hurting ergonomy and the users' long-term productivity and efficiency.
It goes without saying that it has to be escaped in most shells, but that is the traditional option for help on UNIX®️. You would be well advised to educate yourself on the history of UNIX®️ before coming up with "what are you smoking?"
I see nothing wrong with extensive SYNOPSIS and EXAMPLES sections for programs using --long-options.
The fish shell extracts completion information from man pages, so that the user does not have to type so much and they get useful output, pulled from the manpage, no less.
Implementing --long-options makes the poor users type much more, hurting ergonomy and the users' long-term productivity and efficiency.