Wrong cross-references in incremental doc builds

[kwankyu]

After #22588, it is observed that there are wrong cross-references in the reference manual built incrementally (that is, not from scratch). This anomaly was not introduced by the patch at #22588, but rather the patch enables us to see it.

See the reports at

#22588 comment:48

#22588 comment:49

The problem of wrong cross-references seems related with how intersphinx extension works. A (partial) fix might be to update the intersphinx inventory files somehow when the auto-generated .rst files are updated.

CC: @embray @hivert @jdemeyer @jhpalmieri @kcrisman @slel

Component: documentation

Issue created by migration from https://trac.sagemath.org/ticket/23602

[slel]

comment:1

Cc-ing participants in #22588. Is the problem discussed at [0], [1] still present?

• [0] #22588 comment:48
• [1] #22588 comment:49

[jhpalmieri]

comment:2

Sure. You can also just follow the directions in #22588 comment:48, for example, and see for yourself.

[embray]

comment:3

I'm a little confused because of the chronological ordering of these tickets, but I think this general issue was fixed/worked around by #21044. I'm confirming though...

[embray]

comment:4

Actually I think it might be a different issue.