investigate: Why Sphinx generates i18n.inconsistent.reference warnings when building translations

[flpm]

Currently, we are suppressing the i18n.inconsistent.reference warnings in conf.py. This is needed in order to release the partial translations for Spanish and Portuguese.

We need to investigate why this is happening and if there is a better solutions. Initial review seems to suggest that Sphinx ignores the translated terms in the glossary and complains that the translation is not the same term as the English. But this needs confirmation.

If you are going to work on this issue:

• temporarily remove the suppression of warnings in conf.py
• build all the languages of the guide using nox -s build-all-languages-test
• look for warnings mentioning i18n.inconsistent.references

Suppression introduced in PR:

[sneakers-the-rat]

Looks like this is number 5 on here: sphinx-doc/sphinx#14162

So it looks like a solution might be to use the English term in the link portion?
Like they give the example

:term:`codificação da localidade <locale encoding>`

Does that work here?

Other linked issues and PRs from that issue look like they're capping sphinx <9

[flpm]

Interesting, thanks! I will take a look, I did not try that.