[3.13] gh-126676: Expand argparse docs for type=bool with warning and alternatives (GH-146435)

[3.13] gh-126676: Expand argparse docs for type=bool with warning and alternatives (GH-146435) #248373