gh-126676: Expand argparse docs for type=bool with warning and alternatives (#146435)

Co-authored-by: joshuaswanson <joshuaswanson@users.noreply.github.com>
Co-authored-by: Savannah Ostrowski <savannah@python.org>