FF91 - Update docs with Feature-Policy: Gamepad and secure context

[hamishwillee]

FF91 starts protecting the gamepad API using Feature-Policy: gamepad, and also only allows this to be called in secure contexts. This PR

• Adds secure context header to all Gamepad API docs
• Adds docs for the new permission policy
• Adds info about the new permission policy in the API docs that are directly affected.

More context can be found in #6723

[github-actions]

Preview URLs

• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/HTTP/Headers/Feature-Policy
• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/HTTP/Headers/Feature-Policy/gamepad
• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/HTTP/Feature_Policy
• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/Window/gamepaddisconnected_event
• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/Window/gamepadconnected_event
• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/Gamepad
• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/GamepadButton
• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/GamepadHapticActuator
• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/GamepadEvent
• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/GamepadEvent/gamepad
• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/Navigator/getGamepads
• https://pr7269.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/Gamepad_API

Flaws

Note! 4 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/HTTP/Headers/Feature-Policy
Title: Feature-Policy
on GitHub
Flaw count: 1

• macros:
  • /en-US/docs/Web/API/Navigator/requestMIDIAccess does not exist

---

URL: /en-US/docs/Web/HTTP/Headers/Feature-Policy/gamepad
Title: Feature-Policy: gamepad
on GitHub
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: http.headers.Feature-Policy.gamepad

---

URL: /en-US/docs/Web/HTTP/Feature_Policy
Title: Feature Policy
on GitHub
Flaw count: 1

• broken_links:
  • Is currently http:// but can become https://

---

URL: /en-US/docs/Web/API/Window/gamepaddisconnected_event
Title: Window: gamepaddisconnected event
on GitHub
Flaw count: 5

• macros:
  • /en-us/docs/web/api/globalcrypto (url: /en-US/docs/Web/API/GlobalCrypto) does not exist
  • /en-us/docs/web/api/speechsynthesisgetter (url: /en-US/docs/Web/API/SpeechSynthesisGetter) does not exist
  • /en-us/docs/web/api/windowmodal (url: /en-US/docs/Web/API/WindowModal) does not exist
  • /en-us/docs/web/api/onerroreventhandlerforwindow (url: /en-US/docs/Web/API/OnErrorEventHandlerForWindow) does not exist
  • /en-us/docs/web/api/chromewindow (url: /en-US/docs/Web/API/ChromeWindow) does not exist

---

URL: /en-US/docs/Web/API/Window/gamepadconnected_event
Title: Window: gamepadconnected event
on GitHub
Flaw count: 5

• macros:
  • /en-us/docs/web/api/globalcrypto (url: /en-US/docs/Web/API/GlobalCrypto) does not exist
  • /en-us/docs/web/api/speechsynthesisgetter (url: /en-US/docs/Web/API/SpeechSynthesisGetter) does not exist
  • /en-us/docs/web/api/windowmodal (url: /en-US/docs/Web/API/WindowModal) does not exist
  • /en-us/docs/web/api/onerroreventhandlerforwindow (url: /en-US/docs/Web/API/OnErrorEventHandlerForWindow) does not exist
  • /en-us/docs/web/api/chromewindow (url: /en-US/docs/Web/API/ChromeWindow) does not exist

---

URL: /en-US/docs/Web/API/GamepadButton
Title: GamepadButton
on GitHub
Flaw count: 2

• macros:
  • wrong xref macro used (consider changing which macro you use)
• bad_bcd_links:
  • no explanation!

---

URL: /en-US/docs/Web/API/GamepadEvent
Title: GamepadEvent
on GitHub
Flaw count: 4

• macros:
  • /en-US/docs/Web/API/Window/gamepadconnected does not exist
  • /en-US/docs/Web/API/Window/gamepaddisconnected does not exist
  • /en-US/docs/Web/API/Window/gamepadconnected does not exist
  • /en-US/docs/Web/API/Window/gamepaddisconnected does not exist

---

URL: /en-US/docs/Web/API/Navigator/getGamepads
Title: Navigator.getGamepads()
on GitHub
Flaw count: 1

• broken_links:
  • Can't resolve /en-US/docs/Web/Guide/API/Gamepad

External URLs

URL: /en-US/docs/Web/HTTP/Headers/Feature-Policy
Title: Feature-Policy
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/HTTP/Headers/Feature-Policy/gamepad
Title: Feature-Policy: gamepad
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/HTTP/Feature_Policy
Title: Feature Policy
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/Window/gamepaddisconnected_event
Title: Window: gamepaddisconnected event
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/Window/gamepadconnected_event
Title: Window: gamepadconnected event
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/Gamepad
Title: Gamepad
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/GamepadButton
Title: GamepadButton
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/GamepadHapticActuator
Title: GamepadHapticActuator
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/GamepadEvent
Title: GamepadEvent
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/GamepadEvent/gamepad
Title: GamepadEvent.gamepad
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/Navigator/getGamepads
Title: Navigator.getGamepads()
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/Gamepad_API
Title: Gamepad API
on GitHub

No new external URLs

(this comment was updated 2021-07-26 09:10:51.425155)

[Elchi3]

• Adds secure context header to all Gamepad API docs

Is it really needed to warn on all pages? Would it be sufficient enough to have the banner on interface pages and navigator.getGamepads?

[hamishwillee]

@Elchi3 Technically it depends on how you come to the information. But I agree that almost always you will first come to the interface page, and then to methods etc. I will assume your comment is "policy" and fix up appropriately. Thanks.

[Elchi3]

I'm not sure if this is our policy but I think it should be. See also #7070

[Elchi3]

LGTM, nice! 👍