Günter Milde

Thank you for the report. I'd classify the problem as a documentation issue rather than a bug. The problem is the difference between an reference name and an identifier . Identifiers are derived from reference names via the identifier normalization. Due to identifier restriction in HTML4, a reference name consisting of only digits "vanishes completely" unless prefixed. (cf. https://sourceforge.net/p/docutils/feature-requests/66/). This is why the reference-name "5" is replaced by the auto-generated...

Superseded by the more generic approach discussed in [feature-requests:#66].

Superseded by the more generic approach discussed in [Feature Requests:#66].

Superseded by the more generic approach discussed in [feature-requests:#66].

Fix `Transition` post-processing transform.

Fix nodes.transition.validate_position()

Re-sort class definitions in nodes.py.

Update various comments and docstrings.