Explanation of `bounded-floor`/`local`/`local-floor` needs improvement

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/XRReferenceSpace

What specific section or headline is this issue about?

bounded-floor/local/local-floor/etc explanations

What information was incorrect, unhelpful, or incomplete?

The explanations being based around phrases like "the user is not expected to" weren't helpful for me.

What did you expect to see?

If my understanding is correct, then I think it'd be helpful to add a couple more sentences to each explanation - something like these:

• local: [...] Recentering affects all three axes. So, for example, if you crouch down and then recenter, that will cause the virtual world to be "lowered" relative to the real world.
• local-floor: [...] Recentering affects the two horizontal axes while keeping the vertical aligned with your real floor. So, for example, if you crouch down and then recenter, the world will not be "lowered" relative to the real world - i.e. recentering after a vertical movement will not move the virtual world relative to the real world at all.

Please include some plain language and examples like this to help the reader understand.

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

I asked a friend who was just starting to do some WebXR stuff too, and they didn't understand the explanations on that page either, so I don't think this is a 'me' problem.

MDN metadata

• Folder: en-us/web/api/xrreferencespace
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/XRReferenceSpace
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/api/xrreferencespace/index.md
• Last commit: https://github.com/mdn/content/commit/acfe8c9f1f4145f77653a2bc64a9744b001358dc
• Document last modified: 2023-07-07T07:19:19.000Z