Thanks @Paige-Shopify!
FWIW, updating the docs was the whole purpose behind OP’s post here, which was posted back in December of 2025 (@Jivan is my colleague).
I suppose the thread evolved into a feature request, but until something changes on the platform/product side, the docs need to be updated to reflect the current state of things, as it’s clearly confusing both internally and externally