The 'Tag reference' and 'Inline tag reference' tables of content
rendered <Unknown> entries for the six .rst files whose only body was
a .. include:: <other>.rst line. Without a top-level title, the
toctree could not extract a label for them.
Replace each include with a proper RST title matching the tag name
plus a short cross-reference and a one-liner that spells out the
variant's specific semantics. Users landing on each URL still get a
clear pointer to the canonical reference page.
Fixes phpDocumentor#3759
The Tag reference and Inline tag reference tables of content on docs.phpdoc.org rendered <Unknown> entries for six .rst files whose only body was a .. include:: <other>.rst line (see #3759). Without a top-level title, the toctree could not extract a label for them.
Replace each include with a proper RST title matching the tag name plus a short cross-reference and a one-liner that spells out the variant's specific semantics. Users landing on each URL still get a clear pointer to the canonical reference page.
Affected files:
Inline-tag titles follow the existing inheritdoc.rst convention (bare @tag, no braces) so the inline-tags toctree stays visually uniform.
Fixes #3759