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!