Improvement to IR docs 2/n (#2229)

Major improvement in documenting all submodules in onnxscript.ir. Also
added documentation for the rewriter, optimizer and version converter.


![image](https://github.com/user-attachments/assets/cdb66f93-0f93-4112-b20f-055f275b2cca)


![image](https://github.com/user-attachments/assets/2610c439-4ecf-4e96-9c9b-ff98b5d6dc23)

Author: justinchuby

.gitignore

@@ -100,7 +100,7 @@ dmypy.json
 *.onnxlib
 **/onnx_backend_test_code/**
 docs/auto_examples/*
-docs/intermediate_representation/generated/*
+docs/**/generated/*
 tests/export/*
 tests/models/testoutputs/*
 tests/mylib.onnxlib

docs/_templates/classtemplate.rst

@@ -7,8 +7,8 @@
 
 .. autoclass:: {{ name }}
     :members:
-
+    :undoc-members:
+    :member-order: bysource
 
 ..
   autogenerated from docs/_templates/classtemplate.rst
-  note it does not have :inherited-members:

docs/_templates/classtemplate_inherited.rst

@@ -0,0 +1,16 @@
+.. role:: hidden
+    :class: hidden-section
+.. currentmodule:: {{ module }}
+
+
+{{ name | underline}}
+
+.. autoclass:: {{ name }}
+    :members:
+    :undoc-members:
+    :inherited-members:
+    :member-order: bysource
+
+
+..
+  autogenerated from docs/_templates/classtemplate.rst

docs/_templates/functiontemplate.rst

@@ -0,0 +1,12 @@
+.. role:: hidden
+    :class: hidden-section
+.. currentmodule:: {{ module }}
+
+
+{{ name | underline}}
+
+.. autofunction:: {{ name }}
+
+
+..
+  autogenerated from docs/_templates/functiontemplate.rst

docs/api/index.md

@@ -3,15 +3,29 @@
 ## Author Models
 
 ```{toctree}
+:maxdepth: 1
+
 decorator
 opsets
 converter
 values
 ```
 
-## Tests and Tools
+## Model transformation
 
 ```{toctree}
+:maxdepth: 1
+
+optimizer
+rewriter
+rewriter_pattern
+version_converter
+```
+
+## Testing
+
+```{toctree}
+:maxdepth: 1
+
 testing
-tools
 ```

docs/api/optimizer.md

@@ -0,0 +1,19 @@
+# onnxscript.optimizer
+
+```{eval-rst}
+.. automodule::onnxscript.optimizer
+.. currentmodule:: onnxscript
+```
+
+```{eval-rst}
+.. autosummary::
+    :toctree: generated
+    :template: functiontemplate.rst
+    :nosignatures:
+
+    optimizer.optimize
+    optimizer.inline
+    optimizer.basic_constant_propagation
+    optimizer.fold_constants
+    optimizer.remove_unused_nodes
+```

docs/api/rewriter.md

@@ -0,0 +1,26 @@
+# onnxscript.rewriter
+
+```{eval-rst}
+.. automodule::onnxscript.rewriter
+.. currentmodule:: onnxscript
+```
+
+```{eval-rst}
+.. autosummary::
+    :toctree: generated
+    :template: functiontemplate.rst
+    :nosignatures:
+
+    rewriter.rewrite
+```
+
+## IR passes
+
+```{eval-rst}
+.. autosummary::
+    :toctree: generated
+    :template: classtemplate.rst
+    :nosignatures:
+
+    rewriter.RewritePass
+```

docs/api/rewriter_pattern.md

@@ -0,0 +1,39 @@
+# onnxscript.rewriter.pattern
+
+```{eval-rst}
+.. automodule::onnxscript.rewriter.pattern
+.. currentmodule:: onnxscript
+```
+
+```{eval-rst}
+.. autosummary::
+    :toctree: generated
+    :template: classtemplate.rst
+    :nosignatures:
+
+    rewriter.pattern.Pattern
+    rewriter.pattern.StringPattern
+    rewriter.pattern.StringConstantPattern
+    rewriter.pattern.PrefixPattern
+    rewriter.pattern.AttrPattern
+    rewriter.pattern.AttrConstantPattern
+    rewriter.pattern.OpsetPatternBuilder
+    rewriter.pattern.OpPatternBuilder
+    rewriter.pattern.MatchResult
+    rewriter.pattern.ValuePattern
+    rewriter.pattern.NodePattern
+    rewriter.pattern.NodeOutputPattern
+    rewriter.pattern.AnyValue
+    rewriter.pattern.Constant
+    rewriter.pattern.GraphPattern
+    rewriter.pattern.ReplacementSubgraph
+    rewriter.pattern.ReplacementPatternFunction
+    rewriter.pattern.PatternMatcher
+    rewriter.pattern.SimplePatternMatcher
+    rewriter.pattern.RewriteRule
+    rewriter.pattern.RewriteRuleAsClass
+    rewriter.pattern.RewriteRuleSet
+    rewriter.pattern.MatchStatus
+    rewriter.pattern.MatchInfo
+    rewriter.pattern.MatchingTracer
+```

docs/api/tools.md

@@ -0,0 +1,28 @@
+# onnxscript.version_converter
+
+```{eval-rst}
+.. automodule::onnxscript.version_converter
+.. currentmodule:: onnxscript
+```
+
+## Functions
+
+```{eval-rst}
+.. autosummary::
+    :toctree: generated
+    :template: functiontemplate.rst
+    :nosignatures:
+
+    version_converter.convert_version
+```
+
+## IR passes
+
+```{eval-rst}
+.. autosummary::
+    :toctree: generated
+    :template: classtemplate.rst
+    :nosignatures:
+
+    version_converter.ConvertVersionPass
+```