Update ONNX docs (#14904)

* Remove docs for deprecated ONNX export

* Tidy up the CLI help messages

* Revamp ONNX docs

* Update auto-config table

* Use DistilBERT as example for consistency

* Wrap up first pass at ONNX docs

* Fix table check

* Add tweaks and introduction

* Add cross-ref

* Fix missing import

* Fix style

* Add permalinks to ONNX configs

* Clarify role of OrderedDict

* Update docs/source/serialization.mdx
Co-authored-by: Sylvain Gugger <35901082+sgugger@users.noreply.github.com>

* Add doctest syntax to code blocks

* Remove permalinks

* Revert "Remove permalinks"

This reverts commit 099701daf0db27823457867938efdb2d4f22a7c1.
Co-authored-by: Sylvain Gugger <35901082+sgugger@users.noreply.github.com>

src/transformers/onnx/__main__.py

@@ -23,17 +23,17 @@ from .features import FeaturesManager
 
 
 def main():
-    parser = ArgumentParser("Hugging Face ONNX Exporter tool")
-    parser.add_argument("-m", "--model", type=str, required=True, help="Model's name of path on disk to load.")
+    parser = ArgumentParser("Hugging Face Transformers ONNX exporter")
+    parser.add_argument(
+        "-m", "--model", type=str, required=True, help="Model ID on huggingface.co or path on disk to load model from."
+    )
     parser.add_argument(
         "--feature",
         choices=list(FeaturesManager.AVAILABLE_FEATURES),
         default="default",
-        help="Export the model with some additional feature.",
-    )
-    parser.add_argument(
-        "--opset", type=int, default=None, help="ONNX opset version to export the model with (default 12)."
+        help="The type of features to export the model with.",
     )
+    parser.add_argument("--opset", type=int, default=None, help="ONNX opset version to export the model with.")
     parser.add_argument(
         "--atol", type=float, default=None, help="Absolute difference tolerence when validating the model."
     )

utils/check_table.py

@@ -207,11 +207,11 @@ def get_onnx_model_list():
 
 
 def check_onnx_model_list(overwrite=False):
-    """Check the model list in the serialization.rst is consistent with the state of the lib and maybe `overwrite`."""
+    """Check the model list in the serialization.mdx is consistent with the state of the lib and maybe `overwrite`."""
     current_list, start_index, end_index, lines = _find_text_in_file(
         filename=os.path.join(PATH_TO_DOCS, "serialization.mdx"),
         start_prompt="<!--This table is automatically generated by make style, do not fill manually!-->",
-        end_prompt="This conversion is handled with the PyTorch version of models ",
+        end_prompt="The ONNX conversion is supported for the PyTorch versions of the models.",
     )
     new_list = get_onnx_model_list()