Make Valid Usage blocks collapsible

[SaschaWillems]

Some of the Valid usage blocks are extremely large. For chapters that have multiple such blocks this makes it hard to find the actual spec text. E.g. the Drawing Commands chapter. This makes it unnecessary hard to read.

(edit @oddhack: note this is also tracked in internal vulkan/vulkan issue 2889).

[oddhack]

This is tricky. AFAICT if we default to making VUID blocks collapsed, then opening a deep link to a VUID will not show it. If we don't default to that, then the OOTB behavior is as you say.

This isn't an Antora issue, the same thing exists in the currently published specs and there's an internal issue about it in the vulkan spec repo, but no agreed path forward.

[oddhack]

@gpx1000 suggested that we could use JS that would have access to not just the URL, but the anchor in the DOM, so that if you opened the site as explicitly ...#VUID-... it could uncollapse the VUs, and otherwise collapse them. Also that there could be persistent state in the form of a cookie to record the user preference.

[SaschaWillems]

Sounds like an option. Cookies might be problematic though, at least for people from countries that fall under the GDPR (e.g. all of the EU).

[oddhack]

Sounds like an option. Cookies might be problematic though, at least for people from countries that fall under the GDPR (e.g. all of the EU).

If there's record-keeping involved with people opting in/out then that's an issue. Maybe @gpx1000 knows some other way to retain persistent state in the browser? This isn't state that our servers would request or want.