JP-3471 improve Step.spec attribute formating in docs

[braingram]

Resolves JP-3471

Closes #8085

This PR adds a custom AttributeDocumenter subclass to control the formatting of the long Step.spec string in the sphinx documentation.

For one example see the OutlierDetectionStep spec:
https://jwst-pipeline.readthedocs.io/en/latest/api/jwst.outlier_detection.OutlierDetectionStep.html#jwst.outlier_detection.OutlierDetectionStep.spec

and with this PR:
https://jwst-pipeline--8101.org.readthedocs.build/en/8101/api/jwst.outlier_detection.OutlierDetectionStep.html#jwst.outlier_detection.OutlierDetectionStep.spec

To update the formatting outside of api a few uses of automodule are replaced with automodapi:

• tweakreg: https://jwst-pipeline--8101.org.readthedocs.build/en/8101/jwst/tweakreg/index.html
• skymatch: https://jwst-pipeline--8101.org.readthedocs.build/en/8101/jwst/skymatch/index.html
• mrs_imatch: https://jwst-pipeline--8101.org.readthedocs.build/en/8101/jwst/mrs_imatch/index.html#module-jwst.mrs_imatch

One change to the code was necessary (adding an __all__ to jwst/tweakreg/astrometric_utils.py to allow automodapi to pick up the documentation for TIMEOUT see: https://jwst-pipeline--8101.org.readthedocs.build/en/8101/jwst/tweakreg/astrometric_utils.html#variables).

Checklist for maintainers

• added entry in CHANGES.rst within the relevant release section
• updated or added relevant tests
• updated relevant documentation
• added relevant milestone
• added relevant label(s)
• ran regression tests, post a link to the Jenkins job below.
  How to run regression tests on a PR
• Make sure the JIRA ticket is resolved properly

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (2b36da4) 75.92% compared to head (7b5be8a) 75.93%.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #8101   +/-   ##
=======================================
  Coverage   75.92%   75.93%           
=======================================
  Files         459      459           
  Lines       37615    37616    +1     
=======================================
+ Hits        28561    28562    +1     
  Misses       9054     9054           

Flag	Coverage Δ		*Carryforward flag
nightly	77.37% <ø> (ø)		Carriedforward from c340825

*This pull request uses carry forward flags. Click here to find out more.

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

[mcara]

Oh wow! I am impressed!

[hbushouse]

Wow, the docs now look great! Nice job.

But what's causing all the CI tests to fail in the jwst/tweakreg/tests/test_amutils.py test module?

[braingram]

Thanks for pointing that out!
I also saw a SSL warning in the logs so I'm thinking the service where the catalogs are downloaded from dropped the ball (perhaps due to the other network issues yesterday).
I didn't see those failures in earlier runs or locally. I closed and reopened this to trigger the CI.

[hbushouse]

OK, looks good now.