You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository has been archived by the owner on Aug 6, 2024. It is now read-only.
Near as I can tell, rstcheck doesn't validate for a well-formed URI inside the hyperlink. The docutils spec for RST is here - https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#embedded-uris-and-aliases
The links that are quietly broken (not found by CI), are as follows: Control Node Requirements <:ref:control-node-requirements>_
So it has a title (Control Node Requirements) and a URI . So if nothing acutally checks the blablabla, the test passes.
That syntax is used for external links. The internal link syntax is :ref:Control Node Requirments <blablabla>
and if that were incorrect, rstcheck would flag it.
So a correct external link would be Control Node Requirements <http://docs.ansible.com/blablbla>_
aka it was a clever way of combining the two to seem like it would work, but didn't, and didn't fail tests either
per Matt Clay's request:
ansible/ansible#78424
Fixes a broken reference. The question is - why was this problem not picked up by the ansible/ansible CI infrastructure.
The text was updated successfully, but these errors were encountered: