Add API overview page for Device Orientation Events (mdn#20385)

* Add API overview page for Device Orientation Events Fixes mdn#2644 * Update all links to the existing guide pages we moved
himanshugarg · Sep 27, 2022 · 91b2e02 · 91b2e02
1 parent 26771d4
commit 91b2e02
Show file tree

Hide file tree

Showing 35 changed files with 205 additions and 133 deletions.
diff --git a/files/en-us/_redirects.txt b/files/en-us/_redirects.txt
@@ -1581,7 +1581,7 @@
 /en-US/docs/DOM/NodeList.item2	/en-US/docs/Web/API/NodeList/item
 /en-US/docs/DOM/NotifyAudioAvailableEvent	/en-US/docs/Web/API/NotifyAudioAvailableEvent
 /en-US/docs/DOM/Option	/en-US/docs/Web/API/HTMLOptionElement/Option
-/en-US/docs/DOM/Orientation_and_motion_data_explained	/en-US/docs/Web/Events/Orientation_and_motion_data_explained
+/en-US/docs/DOM/Orientation_and_motion_data_explained	/en-US/docs/Web/API/Device_orientation_events/Orientation_and_motion_data_explained
 /en-US/docs/DOM/PannerNode	/en-US/docs/Web/API/PannerNode
 /en-US/docs/DOM/Plugin	/en-US/docs/Web/API/Plugin
 /en-US/docs/DOM/PluginArray	/en-US/docs/Web/API/PluginArray
@@ -1726,7 +1726,7 @@
 /en-US/docs/DOM/Touch_events_(Mozilla_experimental)	/en-US/docs/Web/API/Touch_events
 /en-US/docs/DOM/UIEvent	/en-US/docs/Web/API/UIEvent
 /en-US/docs/DOM/UserProximityEvent	/en-US/docs/Web/API/UserProximityEvent
-/en-US/docs/DOM/Using_device_orientation_with_3D_transforms	/en-US/docs/Web/Events/Using_device_orientation_with_3D_transforms
+/en-US/docs/DOM/Using_device_orientation_with_3D_transforms	/en-US/docs/Web/API/Device_orientation_events/Using_device_orientation_with_3D_transforms
 /en-US/docs/DOM/Using_dynamic_styling_information	/en-US/docs/Web/API/CSS_Object_Model/Using_dynamic_styling_information
 /en-US/docs/DOM/Using_full-screen_mode	/en-US/docs/Web/API/Fullscreen_API
 /en-US/docs/DOM/Using_fullscreen_mode	/en-US/docs/Web/API/Fullscreen_API
@@ -2707,7 +2707,7 @@
 /en-US/docs/DataTypeSet	/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browsingData/DataTypeSet
 /en-US/docs/Deer_Park	/en-US/docs/Mozilla/Firefox/Releases/1.5
 /en-US/docs/Demos_of_open_web_technologies	/en-US/docs/Web/Demos
-/en-US/docs/Detecting_device_orientation	/en-US/docs/Web/Events/Detecting_device_orientation
+/en-US/docs/Detecting_device_orientation	/en-US/docs/Web/API/Device_orientation_events/Detecting_device_orientation
 /en-US/docs/Determining_the_dimensions_of_elements	/en-US/docs/Web/API/CSS_Object_Model/Determining_the_dimensions_of_elements
 /en-US/docs/DeviceAcceleration	/en-US/docs/Web/API/DeviceMotionEventAcceleration
 /en-US/docs/Devmo:How_to_Help	/en-US/docs/MDN/Community/Contributing/Getting_started
@@ -2908,7 +2908,7 @@
 /en-US/docs/Document_Object_Model_(DOM)/NodeIterator.whatToShow	/en-US/docs/Web/API/NodeIterator/whatToShow
 /en-US/docs/Document_Object_Model_(DOM)/NodeList	/en-US/docs/Web/API/NodeList
 /en-US/docs/Document_Object_Model_(DOM)/NotifyAudioAvailableEvent	/en-US/docs/Web/API/NotifyAudioAvailableEvent
-/en-US/docs/Document_Object_Model_(DOM)/Orientation_and_motion_data_explained	/en-US/docs/Web/Events/Orientation_and_motion_data_explained
+/en-US/docs/Document_Object_Model_(DOM)/Orientation_and_motion_data_explained	/en-US/docs/Web/API/Device_orientation_events/Orientation_and_motion_data_explained
 /en-US/docs/Document_Object_Model_(DOM)/Plugin	/en-US/docs/Web/API/Plugin
 /en-US/docs/Document_Object_Model_(DOM)/PluginArray	/en-US/docs/Web/API/PluginArray
 /en-US/docs/Document_Object_Model_(DOM)/ProcessingInstruction	/en-US/docs/Web/API/ProcessingInstruction
@@ -7301,7 +7301,7 @@
 /en-US/docs/Useful_CSS_tips:Tables	/en-US/docs/Web/CSS/border-collapse
 /en-US/docs/User_Agent_Strings_Reference	/en-US/docs/Web/HTTP/Headers/User-Agent/Firefox
 /en-US/docs/Using_DOM_workers	/en-US/docs/Web/API/Web_Workers_API/Using_web_workers
-/en-US/docs/Using_Deviceorientation_In_3D_Transforms	/en-US/docs/Web/Events/Using_device_orientation_with_3D_transforms
+/en-US/docs/Using_Deviceorientation_In_3D_Transforms	/en-US/docs/Web/API/Device_orientation_events/Using_device_orientation_with_3D_transforms
 /en-US/docs/Using_Firefox_1.5_caching	/en-US/docs/Mozilla/Firefox/Releases/1.5/Using_Firefox_1.5_caching
 /en-US/docs/Using_HTML5_audio_and_video	/en-US/docs/Learn/HTML/Multimedia_and_embedding/Video_and_audio_content
 /en-US/docs/Using_JSON_in_Firefox	/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON
@@ -7840,7 +7840,7 @@
 /en-US/docs/Web/API/DedicatedWorkerGlobalScope/onmessage	/en-US/docs/Web/API/DedicatedWorkerGlobalScope/message_event
 /en-US/docs/Web/API/DedicatedWorkerGlobalScope/onmessageerror	/en-US/docs/Web/API/DedicatedWorkerGlobalScope/messageerror_event
 /en-US/docs/Web/API/DelayNode.delayTime	/en-US/docs/Web/API/DelayNode/delayTime
-/en-US/docs/Web/API/Detecting_device_orientation	/en-US/docs/Web/Events/Detecting_device_orientation
+/en-US/docs/Web/API/Detecting_device_orientation	/en-US/docs/Web/API/Device_orientation_events/Detecting_device_orientation
 /en-US/docs/Web/API/DeviceAcceleration	/en-US/docs/Web/API/DeviceMotionEventAcceleration
 /en-US/docs/Web/API/DeviceAcceleration.x	/en-US/docs/Web/API/DeviceMotionEventAcceleration/x
 /en-US/docs/Web/API/DeviceAcceleration.y	/en-US/docs/Web/API/DeviceMotionEventAcceleration/y
@@ -11435,6 +11435,7 @@
 /en-US/docs/Web/Events/Activate	/en-US/docs/Web/API/Element/DOMActivate_event
 /en-US/docs/Web/Events/DOMContentLoaded	/en-US/docs/Web/API/Window/DOMContentLoaded_event
 /en-US/docs/Web/Events/DOMMouseScroll	/en-US/docs/Web/API/Element/DOMMouseScroll_event
+/en-US/docs/Web/Events/Detecting_device_orientation	/en-US/docs/Web/API/Device_orientation_events/Detecting_device_orientation
 /en-US/docs/Web/Events/FontFaceSetLoadEvent	/en-US/docs/Web/API/FontFaceSetLoadEvent
 /en-US/docs/Web/Events/MSGestureChange	/en-US/docs/Web/API/Element/MSGestureChange_event
 /en-US/docs/Web/Events/MSGestureEnd	/en-US/docs/Web/API/Element/MSGestureEnd_event
@@ -11444,8 +11445,10 @@
 /en-US/docs/Web/Events/MSInertiaStart	/en-US/docs/Web/API/Element/MSInertiaStart_event
 /en-US/docs/Web/Events/MSManipulationStateChanged	/en-US/docs/Web/API/Element/MSManipulationStateChanged_event
 /en-US/docs/Web/Events/MozMousePixelScroll	/en-US/docs/Web/API/Element/MozMousePixelScroll_event
+/en-US/docs/Web/Events/Orientation_and_motion_data_explained	/en-US/docs/Web/API/Device_orientation_events/Orientation_and_motion_data_explained
 /en-US/docs/Web/Events/SVGError	/en-US/docs/Web/API/SVGElement/error_event
 /en-US/docs/Web/Events/SVGLoad	/en-US/docs/Web/API/SVGElement/load_event
+/en-US/docs/Web/Events/Using_device_orientation_with_3D_transforms	/en-US/docs/Web/API/Device_orientation_events/Using_device_orientation_with_3D_transforms
 /en-US/docs/Web/Events/abort	/en-US/docs/Web/API/HTMLMediaElement/abort_event
 /en-US/docs/Web/Events/abort_(ProgressEvent)	/en-US/docs/Web/API/XMLHttpRequest/abort_event
 /en-US/docs/Web/Events/abort_(cancellable_fetch)	/en-US/docs/Web/API/AbortSignal/abort_event
@@ -11693,10 +11696,10 @@
 /en-US/docs/Web/Guide/API/DOM/Events/Creating_and_triggering_events	/en-US/docs/Web/Events/Creating_and_triggering_events
 /en-US/docs/Web/Guide/API/DOM/Events/Event_dispatching_example	/en-US/docs/Web/Events/Creating_and_triggering_events
 /en-US/docs/Web/Guide/API/DOM/Events/Event_handlers	/en-US/docs/Web/Events/Event_handlers
-/en-US/docs/Web/Guide/API/DOM/Events/Orientation_and_motion_data_explained	/en-US/docs/Web/Events/Orientation_and_motion_data_explained
+/en-US/docs/Web/Guide/API/DOM/Events/Orientation_and_motion_data_explained	/en-US/docs/Web/API/Device_orientation_events/Orientation_and_motion_data_explained
 /en-US/docs/Web/Guide/API/DOM/Events/Touch_events	/en-US/docs/Web/API/Touch_events
 /en-US/docs/Web/Guide/API/DOM/Events/Touch_events_(Mozilla_experimental)	/en-US/docs/Web/API/Touch_events
-/en-US/docs/Web/Guide/API/DOM/Events/Using_device_orientation_with_3D_transforms	/en-US/docs/Web/Events/Using_device_orientation_with_3D_transforms
+/en-US/docs/Web/Guide/API/DOM/Events/Using_device_orientation_with_3D_transforms	/en-US/docs/Web/API/Device_orientation_events/Using_device_orientation_with_3D_transforms
 /en-US/docs/Web/Guide/API/DOM/Locating_DOM_elements_using_selectors	/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors
 /en-US/docs/Web/Guide/API/DOM/Manipulating_the_browser_history	/en-US/docs/Web/API/History_API
 /en-US/docs/Web/Guide/API/DOM/Manipulating_the_browser_history/Example	/en-US/docs/Web/API/History_API/Example
@@ -11760,10 +11763,10 @@
 /en-US/docs/Web/Guide/DOM/Events/Creating_and_triggering_events	/en-US/docs/Web/Events/Creating_and_triggering_events
 /en-US/docs/Web/Guide/DOM/Events/Event_dispatching_example	/en-US/docs/Web/Events/Creating_and_triggering_events
 /en-US/docs/Web/Guide/DOM/Events/Event_handlers	/en-US/docs/Web/Events/Event_handlers
-/en-US/docs/Web/Guide/DOM/Events/Orientation_and_motion_data_explained	/en-US/docs/Web/Events/Orientation_and_motion_data_explained
+/en-US/docs/Web/Guide/DOM/Events/Orientation_and_motion_data_explained	/en-US/docs/Web/API/Device_orientation_events/Orientation_and_motion_data_explained
 /en-US/docs/Web/Guide/DOM/Events/Touch_events	/en-US/docs/Web/API/Touch_events
 /en-US/docs/Web/Guide/DOM/Events/Touch_events_(Mozilla_experimental)	/en-US/docs/Web/API/Touch_events
-/en-US/docs/Web/Guide/DOM/Events/Using_device_orientation_with_3D_transforms	/en-US/docs/Web/Events/Using_device_orientation_with_3D_transforms
+/en-US/docs/Web/Guide/DOM/Events/Using_device_orientation_with_3D_transforms	/en-US/docs/Web/API/Device_orientation_events/Using_device_orientation_with_3D_transforms
 /en-US/docs/Web/Guide/DOM/Locating_DOM_elements_using_selectors	/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors
 /en-US/docs/Web/Guide/DOM/Manipulating_the_browser_history	/en-US/docs/Web/API/History_API
 /en-US/docs/Web/Guide/DOM/Manipulating_the_browser_history/Example	/en-US/docs/Web/API/History_API/Example
@@ -11778,11 +11781,11 @@
 /en-US/docs/Web/Guide/Events/Event_handlers	/en-US/docs/Web/Events/Event_handlers
 /en-US/docs/Web/Guide/Events/Media_events	/en-US/docs/Web/Events#media
 /en-US/docs/Web/Guide/Events/Mutation_events	/en-US/docs/Web/API/MutationEvent
-/en-US/docs/Web/Guide/Events/Orientation_and_motion_data_explained	/en-US/docs/Web/Events/Orientation_and_motion_data_explained
+/en-US/docs/Web/Guide/Events/Orientation_and_motion_data_explained	/en-US/docs/Web/API/Device_orientation_events/Orientation_and_motion_data_explained
 /en-US/docs/Web/Guide/Events/Overview_of_Events_and_Handlers	/en-US/docs/Web/Events
 /en-US/docs/Web/Guide/Events/Touch_events	/en-US/docs/Web/API/Touch_events
 /en-US/docs/Web/Guide/Events/Touch_events_(Mozilla_experimental)	/en-US/docs/Web/API/Touch_events
-/en-US/docs/Web/Guide/Events/Using_device_orientation_with_3D_transforms	/en-US/docs/Web/Events/Using_device_orientation_with_3D_transforms
+/en-US/docs/Web/Guide/Events/Using_device_orientation_with_3D_transforms	/en-US/docs/Web/API/Device_orientation_events/Using_device_orientation_with_3D_transforms
 /en-US/docs/Web/Guide/File_System_API	/en-US/docs/Web/API/File_and_Directory_Entries_API/Introduction
 /en-US/docs/Web/Guide/File_System_API/Introduction	/en-US/docs/Web/API/File_and_Directory_Entries_API/Introduction
 /en-US/docs/Web/Guide/Graphics/Drawing_graphics_with_canvas	/en-US/docs/Web/API/Canvas_API/Tutorial
@@ -12587,7 +12590,7 @@
 /en-US/docs/WebAPI	/en-US/docs/Web/API
 /en-US/docs/WebAPI/Battery_Status	/en-US/docs/Web/API/Battery_Status_API
 /en-US/docs/WebAPI/CSS	/en-US/docs/Web/API/CSS
-/en-US/docs/WebAPI/Detecting_device_orientation	/en-US/docs/Web/Events/Detecting_device_orientation
+/en-US/docs/WebAPI/Detecting_device_orientation	/en-US/docs/Web/API/Device_orientation_events/Detecting_device_orientation
 /en-US/docs/WebAPI/Encoding_API	/en-US/docs/Web/API/Encoding_API
 /en-US/docs/WebAPI/FileHandle	/en-US/docs/Web/API/File_and_Directory_Entries_API
 /en-US/docs/WebAPI/FileHandle_API	/en-US/docs/Web/API/File_and_Directory_Entries_API

diff --git a/files/en-us/_wikihistory.json b/files/en-us/_wikihistory.json
@@ -27975,6 +27975,71 @@
     "modified": "2020-11-30T19:13:18.132Z",
     "contributors": ["peterbe", "bershanskiy"]
   },
+  "Web/API/Device_orientation_events/Detecting_device_orientation": {
+    "modified": "2020-12-12T15:14:52.846Z",
+    "contributors": [
+      "bershanskiy",
+      "rakuco",
+      "MasterOdin",
+      "henchies",
+      "fscholz",
+      "dylanpyle",
+      "psimyn",
+      "rileym7",
+      "cthorner",
+      "Sheppy",
+      "newyork-anthonyng",
+      "timdream",
+      "erikadoyle",
+      "Sebastianz",
+      "mocas0",
+      "andregarzia",
+      "kscarfone",
+      "chrisdavidmills",
+      "SpencerG",
+      "teoli",
+      "Jeremie",
+      "Maroosko",
+      "Seta00",
+      "jrubenoff",
+      "ethertank",
+      "justinpotts",
+      "FredB",
+      "Maheswaran.Shenthuran",
+      "ziyunfei",
+      "kohei.yoshino",
+      "tallowen",
+      "louisremi",
+      "cgack",
+      "paul.irish",
+      "inma_610",
+      "fryn"
+    ]
+  },
+  "Web/API/Device_orientation_events/Orientation_and_motion_data_explained": {
+    "modified": "2020-01-18T20:53:28.435Z",
+    "contributors": [
+      "gerfolder",
+      "sideshowbarker",
+      "jdashg",
+      "dphenderson",
+      "Jeremie",
+      "Sheppy",
+      "kohei.yoshino"
+    ]
+  },
+  "Web/API/Device_orientation_events/Using_device_orientation_with_3D_transforms": {
+    "modified": "2020-12-08T08:00:07.314Z",
+    "contributors": [
+      "rakuco",
+      "chrisdavidmills",
+      "jswisher",
+      "cxoon",
+      "Jeremie",
+      "Sheppy",
+      "louisremi"
+    ]
+  },
   "Web/API/DirectoryEntrySync": {
     "modified": "2020-10-15T21:08:18.522Z",
     "contributors": ["connorshea", "teoli", "kscarfone", "Sheppy", "grendel"]
@@ -94373,47 +94438,6 @@
       "hamishwillee"
     ]
   },
-  "Web/Events/Detecting_device_orientation": {
-    "modified": "2020-12-12T15:14:52.846Z",
-    "contributors": [
-      "bershanskiy",
-      "rakuco",
-      "MasterOdin",
-      "henchies",
-      "fscholz",
-      "dylanpyle",
-      "psimyn",
-      "rileym7",
-      "cthorner",
-      "Sheppy",
-      "newyork-anthonyng",
-      "timdream",
-      "erikadoyle",
-      "Sebastianz",
-      "mocas0",
-      "andregarzia",
-      "kscarfone",
-      "chrisdavidmills",
-      "SpencerG",
-      "teoli",
-      "Jeremie",
-      "Maroosko",
-      "Seta00",
-      "jrubenoff",
-      "ethertank",
-      "justinpotts",
-      "FredB",
-      "Maheswaran.Shenthuran",
-      "ziyunfei",
-      "kohei.yoshino",
-      "tallowen",
-      "louisremi",
-      "cgack",
-      "paul.irish",
-      "inma_610",
-      "fryn"
-    ]
-  },
   "Web/Events/Event_handlers": {
     "modified": "2020-08-24T04:12:31.453Z",
     "contributors": [
@@ -94444,30 +94468,6 @@
       "Bzbarsky"
     ]
   },
-  "Web/Events/Orientation_and_motion_data_explained": {
-    "modified": "2020-01-18T20:53:28.435Z",
-    "contributors": [
-      "gerfolder",
-      "sideshowbarker",
-      "jdashg",
-      "dphenderson",
-      "Jeremie",
-      "Sheppy",
-      "kohei.yoshino"
-    ]
-  },
-  "Web/Events/Using_device_orientation_with_3D_transforms": {
-    "modified": "2020-12-08T08:00:07.314Z",
-    "contributors": [
-      "rakuco",
-      "chrisdavidmills",
-      "jswisher",
-      "cxoon",
-      "Jeremie",
-      "Sheppy",
-      "louisremi"
-    ]
-  },
   "Web/Guide": {
     "modified": "2020-12-10T17:35:22.294Z",
     "contributors": [

diff --git a/files/en-us/games/techniques/3d_on_the_web/webvr/index.md b/files/en-us/games/techniques/3d_on_the_web/webvr/index.md
@@ -26,7 +26,7 @@ With the popularity of Oculus Rift and a lot of other devices in production comi
 
 The [WebVR API](/en-US/docs/Web/API/WebVR_API) is the central API for capturing information on VR Devices connected to a computer and headset position/orientation/velocity/acceleration information, and converting that into useful data you can use in your games and other applications.
 
-> **Note:** There are of course other APIs useful for creating games, for example [The Gamepad API](/en-US/docs/Web/API/Gamepad_API) for control inputs, and the [Device Orientation API](/en-US/docs/Web/Events/Detecting_device_orientation) for handling display orientation on mobile.
+> **Note:** There are of course other APIs useful for creating games, for example [The Gamepad API](/en-US/docs/Web/API/Gamepad_API) for control inputs, and the [Device Orientation API](/en-US/docs/Web/API/Device_orientation_events/Detecting_device_orientation) for handling display orientation on mobile.
 
 ### Browser support and spec status
 

diff --git a/files/en-us/mdn/writing_guidelines/howto/write_an_api_reference/sidebars/index.md b/files/en-us/mdn/writing_guidelines/howto/write_an_api_reference/sidebars/index.md
@@ -100,7 +100,7 @@ These are all technically optional, but it is strongly encouraged that instead o
     "title": "Detecting device orientation" }
     ```
 
-    Creates a link with the title "Detecting device orientation", which points to [https://developer.mozilla.org/en-US/docs/Web/Events/Detecting_device_orientation](/en-US/docs/Web/Events/Detecting_device_orientation).
+    Creates a link with the title "Detecting device orientation", which points to [https://developer.mozilla.org/en-US/docs/Web/API/Device_orientation_events/Detecting_device_orientation](/en-US/docs/Web/API/Device_orientation_events/Detecting_device_orientation).
 
 7. `"dictionaries"` — an array of strings listing all of the dictionaries which are part of the API.
    Generally, only dictionaries used by more than one property or method should be listed here, unless they are of special significance or are likely to require being referenced from multiple pages.

diff --git a/files/en-us/mozilla/firefox/releases/3.6/index.md b/files/en-us/mozilla/firefox/releases/3.6/index.md
@@ -70,7 +70,7 @@ Gecko 1.9.2 introduces JavaScript 1.8.2, which adds a number of language feature
   - : The [`DataTransfer`](/en-US/docs/Web/API/DataTransfer) object provided to drag listeners now includes a list of files that were dragged.
 - Checking to see if an element matches a specified CSS selector
   - : The new {{domxref("Node.mozMatchesSelector", "element.mozMatchesSelector")}} method lets you determine whether or not an element matches a specified CSS selector. See {{bug(518003)}}.
-- [Detecting device orientation](/en-US/docs/Web/Events/Detecting_device_orientation)
+- [Detecting device orientation](/en-US/docs/Web/API/Device_orientation_events/Detecting_device_orientation)
   - : Content can now detect the orientation of the device if it has a supported accelerometer, using the [`MozOrientation`](/en-US/docs/DOM/MozOrientation) event. Firefox 3.6 supports the accelerometer in Mac laptops.
 - [Detecting document width and height changes](/en-US/docs/DOM/Detecting_document_width_and_height_changes)
   - : The new `MozScrollAreaChanged` event is dispatched whenever the document's `scrollWidth` and/or `scrollHeight` properties change.
@@ -99,7 +99,7 @@ If you're an extension developer, you should start by reading [Updating extensio
 
 ### New features
 
-- [Detecting device orientation](/en-US/docs/Web/Events/Detecting_device_orientation)
+- [Detecting device orientation](/en-US/docs/Web/API/Device_orientation_events/Detecting_device_orientation)
   - : Content can now detect the orientation of the device if it has a supported accelerometer, using the [`MozOrientation`](/en-US/docs/DOM/MozOrientation) event. Firefox 3.6 supports the accelerometer in Mac laptops.
 - [Monitoring HTTP activity](/en-US/docs/Monitoring_HTTP_activity)
   - : You can now monitor HTTP transactions to observe requests and responses in real time.