Update transpose doc

[gramalingam]

Description

Clarify the permutation specification of the Transpose op.

Motivation and Context

It is not clear from the spec whether the i-th input axis corresponds to the perm[i]-th output axis or whether the i-th output axis corresponds to perm[i]-th input axis. Make this clear.

[justinchuby]

Would it be a good idea to address #4611 in the same PR?

[gramalingam]

Would it be a good idea to address #4611 in the same PR?

Maybe. But at least some of those questions require some investigation ... it is easy enough to say 0D and 1D inputs should be supported (the op is well-defined for these cases). But that doesn't mean that a specific implementation will support them ... only if we test it out, will we realize if some assumptions are being made.

[gramalingam]

Added point about perm being optional.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 56.99%. Comparing base (4128a09) to head (426c51b).
Report is 8 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #6072      +/-   ##
==========================================
+ Coverage   56.97%   56.99%   +0.01%     
==========================================
  Files         506      506              
  Lines       30483    30489       +6     
  Branches     4593     4593              
==========================================
+ Hits        17369    17378       +9     
+ Misses      12285    12283       -2     
+ Partials      829      828       -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[gramalingam]

As for the question about 0D input tensors (scalars): it looks like both ONNX shape inference as well as its reference implementation need to be extended/fixed to handle this case.