Ref links

[braingram]

This PR configures sphinx-asdf to create links to other rad schemas when a tag is encountered in the schema.

For example, the current wfi_image schema contains a tag to photometry:
https://rad.readthedocs.io/en/latest/generated/schemas/wfi_image-1.0.0.html
However this link is currently invalid (pointing to asdf://stsci.edu/datamodels/roman/tags/photometry-1.0.0.html). With this PR the link now points to:
https://rad.readthedocs.io/en/latest/generated/schemas/photometry-1.0.0.html

Checklist

• Schema changes discussed at RAD Review Board meeting
• Added entry in CHANGES.rst under the corresponding subsection
• Updated relevant roman_datamodels utilities and tests
• Passed romancal regression testing on Jenkins / PLWishMaster. Link: https://plwishmaster.stsci.edu:8081/job/RT/job/romancal/XXX/

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 95.38%. Comparing base (0fb1239) to head (edc209e).
Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #379   +/-   ##
=======================================
  Coverage   95.38%   95.38%           
=======================================
  Files           4        4           
  Lines         195      195           
=======================================
  Hits          186      186           
  Misses          9        9           

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

[nden]

This looks great! Thanks for implementing it so quickly!

[braingram]

Thanks for the review!

Note that the wildcard usage of external tags (like wcs-*) does not appear to be compatible with sphinx-asdf generating links. This means that similar mapping entries to asdf_schema_resource_mappings won't allow linking to gwcs, asdf-standard, etc. I'd say this is a sphinx-asdf bug but I didn't immediately see a way to fix it. I'll open an issue for sphinx-asdf to track it and once fixed rad can be updated to generate links for non-rad schemas.