See for example https://docs.spring.io/spring-framework/docs/current/reference/html/web-reactive.html#webflux-websocket

It contains

= Introduction to WebSocket

which is not rendered as a heading.

Comment From: sbrannen

This is due to the use of {chapter} in the IDs.

websocket-intro.adoc attempts to use dynamic IDs such as [[{chapter}.websocket-intro]]; whereas, web-uris.adoc uses dynamic IDs such as [id={chapter}.web-uricomponents].

The latter works (at least in this particular arrangement).

I noticed the difference previously while working on a different issue and wondered if it was problematic, but I forgot to follow up on that. Now we know!