Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update some WebVR docs to relate to the more modern WebXR #30721

Merged
merged 8 commits into from
Dec 4, 2023

Conversation

zfox23
Copy link
Contributor

@zfox23 zfox23 commented Dec 1, 2023

Description

Updates some documentation to refer to WebXR rather than WebVR; Updates some sidebar links to previously-undiscoverable WebXR guides.

Motivation

  • Keep folks up-to-date with the latest WebXR APIs
  • Improve discoverability of important content

Additional details

This work came out of a comment on @bsmth's #30696.

Related issues and pull requests

Must be merged with mdn/yari#10111

Copy link
Contributor

github-actions bot commented Dec 1, 2023

Preview URLs

External URLs (9)

URL: /en-US/docs/Games/Techniques/3D_on_the_web
Title: 3D games on the Web


URL: /en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_A-Frame
Title: Building up a basic demo with A-Frame


URL: /en-US/docs/Games/Techniques/3D_on_the_web/WebXR
Title: WebXR — Virtual and Augmented Reality for the Web

(comment last updated: 2023-12-04 17:28:03)

@bsmth
Copy link
Member

bsmth commented Dec 4, 2023

Taking a look now 👀

Co-authored-by: Brian Thomas Smith <brian@smith.berlin>
Co-authored-by: Brian Thomas Smith <brian@smith.berlin>
Co-authored-by: Brian Thomas Smith <brian@smith.berlin>

![A 3D representation of a landscape: it's a pinkish sunset, with a blue mountainous land in the background surrounded by a mirror sea and a darker blue island in the second plan.](sechelt.jpg)

There's also a markup framework called [A-Frame](https://aframe.io/) that offers simple building blocks for WebXR, so you can rapidly build and experiment with VR websites and games: read the [Building up a basic demo with A-Frame](/en-US/docs/Games/Techniques/3D_on_the_web/Building_up_a_basic_demo_with_A-Frame) tutorial for more details.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you think this is a better resource than Three.js, we could list it first as people might assume we're ordering by importance. What do you reckon?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

great suggestion! i think it's a good idea to put the A-Frame resource first, even if A-Frame is less popular than threejs:

  1. our a-frame resource is first-party (i.e. hosted on MDN), which is always good
  2. the a-frame resource is more beginner-oriented and complete

in terms of "importance" - i don't have a strong opinion about which resource is more "important," or what that would even mean 🤔 and because of the above reasons, i don't want to think about "importance" right now 😅. lemme make this swap, please hold...

Copy link
Member

@bsmth bsmth Dec 4, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[non-blocking] Not sure if we have a policy on removing deprecated APIs from groupData, but I noticed it's (WebVR API) the only one here:

image

Copy link
Member

@bsmth bsmth left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some open suggestions for your consideration, but leaving a +1 in advance. Thank you! 👍🏻

zfox23 and others added 3 commits December 4, 2023 12:16
Co-authored-by: Brian Thomas Smith <brian@smith.berlin>
Co-authored-by: Brian Thomas Smith <brian@smith.berlin>
@zfox23 zfox23 merged commit af17418 into mdn:main Dec 4, 2023
8 checks passed
estelle pushed a commit to estelle/content that referenced this pull request Dec 5, 2023
* Update some WebVR docs to relate to the more modern WebXR

* Update files/en-us/games/techniques/3d_on_the_web/webxr/index.md

Co-authored-by: Brian Thomas Smith <brian@smith.berlin>

* Update files/en-us/games/techniques/3d_on_the_web/webxr/index.md

Co-authored-by: Brian Thomas Smith <brian@smith.berlin>

* Update files/en-us/games/techniques/3d_on_the_web/webxr/index.md

Co-authored-by: Brian Thomas Smith <brian@smith.berlin>

* Update files/en-us/games/techniques/3d_on_the_web/webxr/index.md

Co-authored-by: Brian Thomas Smith <brian@smith.berlin>

* Update files/en-us/games/techniques/3d_on_the_web/webxr/index.md

Co-authored-by: Brian Thomas Smith <brian@smith.berlin>

* Reorder

---------

Co-authored-by: Brian Thomas Smith <brian@smith.berlin>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:Games Games docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants