chore(ia): reorg Web/Media #37898

bsmth · 2025-01-31T12:01:39Z

Description

Drafting a Media reorg PR. Directory now has this structure:

./files/en-us/web/media
└── guides
    ├── audio_and_video_delivery
    ├── audio_and_video_manipulation
    ├── autoplay
    ├── dash_adaptive_streaming_for_html_5_video
    ├── formats
    ├── images
    └── streaming

Changes:

Files to look at with actual content changes:

files/en-us/web/media/index.md
- new landing page with macros for subpages
files/en-us/web/media/guides/index.md
- New listing page with macro to list subpages
files/en-us/web/media/guides/formats/index.md
- Uses macro to list subpages

Files with minor fixes:

files/en-us/web/media/guides/audio_and_video_delivery/cross-browser_audio_basics/index.md
- audio "tag" -> "element"
files/en-us/web/media/guides/audio_and_video_delivery/index.md
- audio "tag" -> "element"
- <source> / other elements properly closed
- tutorials -> guides
files/en-us/web/media/guides/audio_and_video_manipulation/index.md
- tutorials -> guides
files/en-us/web/media/guides/dash_adaptive_streaming_for_html_5_video/index.md
- proper See also

Everything else:

All other files change links to the section, nothing to look too closely at.

Motivation

Generating a preview for docs IA & maintenance tasks

github-actions · 2025-01-31T12:03:13Z

Preview URLs (108 pages)

Flaws (94)

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

URL: /en-US/docs/Mozilla/Firefox/Releases/3
Title: Firefox 3 for developers
Flaw count: 21

broken_links:
- Can't resolve /en-US/docs/CSS_improvements_in_Firefox_3
- Can't resolve /en-US/docs/New_in_JavaScript_1.8
- Can't resolve /en-US/docs/XUL_improvements_in_Firefox_3
- Can't resolve /en-US/docs/Templates_in_Firefox_3
- Can't resolve /en-US/docs/Extension_Versioning,_Update_and_Compatibility#securing_updates
- and 16 more flaws omitted

URL: /en-US/docs/Mozilla/Firefox/Releases/96
Title: Firefox 96 for developers
Flaw count: 1

broken_links:
- Can't resolve /en-US/docs/Web/API/WebRTC_Statistics_API

URL: /en-US/docs/Mozilla/Firefox/Releases/113
Title: Firefox 113 for developers
Flaw count: 1

broken_links:
- Can't resolve /en-US/docs/Web/API/RTCMediaSourceStats

URL: /en-US/docs/Mozilla/Firefox/Releases/4
Title: Firefox 4 for developers
Flaw count: 40

broken_links:
- Can't resolve /en-US/docs/Optimizing_graphics_performance
- Can't resolve /en-US/docs/DOM/Animations_using_MozBeforePaint
- Can't resolve /en-US/docs/DOM/HTMLWBRElement
- Can't resolve /en-US/docs/Supporting_private_browsing_mode#detecting_whether_private_browsing_mode_is_permanent
- Can't resolve /en-US/docs/Gecko-Specific_DOM_Events#mozafterpaint
- and 33 more flaws omitted
macros:
- Can't resolve /en-US/docs/Web/API/Element/beforescriptexecute
- Can't resolve /en-US/docs/Web/API/Element/afterscriptexecute

URL: /en-US/docs/Web/API/HTMLVideoElement
Title: HTMLVideoElement
Flaw count: 6

macros:
- Can't resolve /en-US/docs/Web/API/HTMLVideoElement/mozParsedFrames
- Can't resolve /en-US/docs/Web/API/HTMLVideoElement/mozDecodedFrames
- Can't resolve /en-US/docs/Web/API/HTMLVideoElement/mozPresentedFrames
- Can't resolve /en-US/docs/Web/API/HTMLVideoElement/mozPaintedFrames
- Can't resolve /en-US/docs/Web/API/HTMLVideoElement/mozFrameDelay
- and 1 more flaws omitted

URL: /en-US/docs/Web/API/HTMLMediaElement
Title: HTMLMediaElement
Flaw count: 6

macros:
- Can't resolve /en-US/docs/Web/API/MediaController
- Can't resolve /en-US/docs/Web/API/MediaController
- Can't resolve /en-US/docs/Web/API/HTMLMediaElement/mozAudioCaptured
- Can't resolve /en-US/docs/Web/API/HTMLMediaElement/mozFragmentEnd
- Can't resolve /en-US/docs/Web/API/HTMLMediaElement/mozCaptureStreamUntilEnded
- and 1 more flaws omitted

URL: /en-US/docs/Web/API/RTCRtpReceiver/getParameters
Title: RTCRtpReceiver: getParameters() method
Flaw count: 1

macros:
- Can't resolve /en-US/docs/Web/API/RTCRtcpParameters

URL: /en-US/docs/Web/API/WebRTC_API
Title: WebRTC API
Flaw count: 6

macros:
- Can't resolve /en-US/docs/Web/API/RTCIceTransport/error_event
- Can't resolve /en-US/docs/Web/API/RTCSctpTransport/error_event
- Can't resolve /en-US/docs/Web/API/RTCDtlsTransport/statechange_event
- Can't resolve /en-US/docs/Web/API/RTCDtlsTransport/statechange_event
- Can't resolve /en-US/docs/Web/API/RTCIdentityProvider
- and 1 more flaws omitted

URL: /en-US/docs/Web/API/WebRTC_API/Connectivity
Title: WebRTC connectivity
Flaw count: 3

macros:
- Can't resolve /en-US/docs/Web/API/RTCIceTransport/error_event
- Can't resolve /en-US/docs/Web/API/RTCSctpTransport/error_event
- Can't resolve /en-US/docs/Web/API/RTCDtlsTransport/statechange_event

URL: /en-US/docs/Web/API/WebRTC_API/Signaling_and_video_calling
Title: Signaling and video calling
Flaw count: 4

macros:
- Can't resolve /en-US/docs/Web/API/RTCIceTransport/error_event
- Can't resolve /en-US/docs/Web/API/RTCSctpTransport/error_event
- Can't resolve /en-US/docs/Web/API/RTCDtlsTransport/statechange_event
- Can't resolve /en-US/docs/Web/API/RTCPeerConnection/removetrack_event

URL: /en-US/docs/Web/API/RTCRtpSender/setParameters
Title: RTCRtpSender: setParameters() method
Flaw count: 1

macros:
- Can't resolve /en-US/docs/Web/API/RTCRtcpParameters

URL: /en-US/docs/Web/API/RTCRtpSender/getParameters
Title: RTCRtpSender: getParameters() method
Flaw count: 1

macros:
- Can't resolve /en-US/docs/Web/API/RTCRtcpParameters

URL: /en-US/docs/Web/API/Web_Audio_API
Title: Web Audio API
Flaw count: 1

macros:
- Macro produces link /en-US/docs/Web/API/Web_Audio_API/Tools which is a redirect

URL: /en-US/docs/Web/API/Web_Audio_API/Using_Web_Audio_API
Title: Using the Web Audio API
Flaw count: 1

macros:
- Macro produces link /en-US/docs/Web/API/Web_Audio_API/Tools which is a redirect

URL: /en-US/docs/Web/HTTP
Title: HTTP
Flaw count: 1

unknown:
- No generic content config found

External URLs (26)

URL: /en-US/docs/Learn_web_development/Core/Structuring_content/HTML_video_and_audio
Title: HTML video and audio

https://github.com/iandevlin/iandevlin.github.io/tree/master/mdn/video-player-with-captions (1 time) (Note! This may be a new URL 👀)
https://iandevlin.github.io/mdn/video-player-with-captions/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Learn_web_development/Core/Scripting/What_is_JavaScript
Title: What is JavaScript?

https://chrisdavidmills.github.io/snapshot/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Learn_web_development/Core/Accessibility/Multimedia
Title: Accessible multimedia

https://github.com/iandevlin/iandevlin.github.io/tree/master/mdn/video-player-with-captions (1 time) (Note! This may be a new URL 👀)
https://iandevlin.github.io/mdn/video-player-with-captions/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Learn_web_development/Extensions/Performance/Multimedia
Title: Multimedia: Images

https://squoosh.app/ (3 times) (Note! This may be a new URL 👀)

URL: /en-US/docs/Mozilla/Firefox/Releases/134
Title: Firefox 134 for developers

https://bugzil.la/1692873 (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Mozilla/Firefox/Releases/66
Title: Firefox 66 for developers

https://bugzil.la/1452146 (1 time) (Note! This may be a new URL 👀)
https://bugzil.la/1521181 (1 time) (Note! This may be a new URL 👀)
https://bugzil.la/1534814 (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Mozilla/Firefox/Releases/113
Title: Firefox 113 for developers

https://bugzil.la/1672276 (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Mozilla/Firefox/Releases/126
Title: Firefox 126 for developers

https://bugzil.la/1860492 (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Mozilla/Firefox/Releases/93
Title: Firefox 93 for developers

https://bugzil.la/1682995 (2 times) (Note! This may be a new URL 👀)

URL: /en-US/docs/Mozilla/Firefox/Releases/125
Title: Firefox 125 for developers

https://bugzil.la/1601817 (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/AudioDecoder/configure
Title: AudioDecoder: configure() method

https://www.w3.org/TR/webcodecs-codec-registry/ (2 times) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/AudioEncoder/configure
Title: AudioEncoder: configure() method

https://www.w3.org/TR/webcodecs-codec-registry/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/VideoEncoder/configure
Title: VideoEncoder: configure() method

https://www.w3.org/TR/webcodecs-codec-registry/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/API/VideoDecoder/configure
Title: VideoDecoder: configure() method

https://www.w3.org/TR/webcodecs-codec-registry/ (2 times) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/Guides/DASH_Adaptive_Streaming_for_HTML_5_Video
Title: DASH Adaptive Streaming for HTML video

https://dashif.org/ (1 time) (Note! This may be a new URL 👀)
https://wiki.webmproject.org/adaptive-streaming/instructions-to-playback-adaptive-webm-using-dash (1 time) (Note! This may be a new URL 👀)
https://wiki.webmproject.org/adaptive-streaming/webm-dash-specification (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/Guides/Audio_and_video_delivery
Title: Audio and video delivery

https://dvcs.w3.org/hg/html-media/raw-file/tip/media-source/isobmff-byte-stream-format.html (1 time) (Note! This may be a new URL 👀)
https://en.wikipedia.org/wiki/M2ts (1 time) (Note! This may be a new URL 👀)
https://jsbin.com/jujeladu/2/edit (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/Guides/Audio_and_video_delivery/Video_player_styling_basics
Title: Video player styling basics

https://ultimatecourses.com/blog/stop-toggling-classes-with-js-use-behaviour-driven-dom-manipulation-with-data-states (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/Guides/Formats/codecs_parameter
Title: Codecs in common media types

https://en.wikipedia.org/wiki/ISO_Base_Media_File_Format (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-01-31 16:37:19)

github-actions · 2025-01-31T13:59:54Z

This pull request has merge conflicts that must be resolved before it can be merged.

pepelsbey

Phew! What a chunk of work :) LGTM, thanks!

(apart from a little pesky tag, sorry)

pepelsbey · 2025-01-31T16:25:36Z

files/en-us/web/media/guides/audio_and_video_delivery/cross-browser_audio_basics/index.md

@@ -36,7 +35,7 @@ The code below is an example of a basic audio implementation using HTML5:
  - `src` contains the path to the audio file to be loaded (relative or absolute).
  - `type` is used to inform the browser of the file type. If omitted, most browsers will attempt to guess this from the file extension.

- If the {{ htmlelement("audio") }} element is not supported then {{ htmlelement("audio") }} and {{ htmlelement("source") }} will be ignored. However, any supported text or elements that you define within {{ htmlelement("audio") }} will be displayed or acted upon. So the ideal place to create a fallback or inform of incompatibility is before the closing `</audio>` tag. In this case, we've provided a simple paragraph including a link to download the audio directly.
+- If the {{ htmlelement("audio") }} element is not supported then {{ htmlelement("audio") }} and {{ htmlelement("source") }} will be ignored. However, any supported text or elements that you define within {{ htmlelement("audio") }} will be displayed or acted upon. So the ideal place to create a fallback or inform of incompatibility is before the closing `</audio>` element. In this case, we've provided a simple paragraph including a link to download the audio directly.


Suggested change

- If the {{ htmlelement("audio") }} element is not supported then {{ htmlelement("audio") }} and {{ htmlelement("source") }} will be ignored. However, any supported text or elements that you define within {{ htmlelement("audio") }} will be displayed or acted upon. So the ideal place to create a fallback or inform of incompatibility is before the closing `</audio>` element. In this case, we've provided a simple paragraph including a link to download the audio directly.

- If the {{ htmlelement("audio") }} element is not supported then {{ htmlelement("audio") }} and {{ htmlelement("source") }} will be ignored. However, any supported text or elements that you define within {{ htmlelement("audio") }} will be displayed or acted upon. So the ideal place to create a fallback or inform of incompatibility is before the closing `</audio>` tag. In this case, we've provided a simple paragraph including a link to download the audio directly.

In this case, it’s a tag. Sorry! 😅

bsmth added 14 commits January 23, 2025 11:44

chore: move media guides

df547df

chore: move media guides

01c1084

Merge branch 'mdn:main' into move-media

5ca1139

Merge branch 'mdn:main' into move-media

ff300d9

feat: add mediasidebar, tidy media dir

8aa0ade

Merge branch 'mdn:main' into move-media

0c341bc

feat: add mediasidebar

cb626eb

feat: add mediasidebar

999413f

feat: add mediasidebar

cd9a3e9

chore: revert sidebar / fmconfig changes

a500d8a

chore: revert web/html/element to resolve conflict

f30d92e

Merge branch 'mdn:main' into move-media

2f2121f

chore: add mediasidebar, fix redirects

f6c9d09

chore: revert unrelated changes

e997d59

github-actions bot added the merge conflicts 🚧 [PR only] label Jan 31, 2025

pepelsbey self-requested a review January 31, 2025 16:12

bsmth added 3 commits January 31, 2025 17:27

chore(ia): update redirects from main

cb89327

chore(ia): update manifest ref from main

2f2c470

chore(ia): update main

42a60ac

github-actions bot removed the merge conflicts 🚧 [PR only] label Jan 31, 2025

pepelsbey approved these changes Jan 31, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

chore(ia): reorg Web/Media #37898

chore(ia): reorg Web/Media #37898

bsmth commented Jan 31, 2025

github-actions bot commented Jan 31, 2025 •

edited

Loading

github-actions bot commented Jan 31, 2025

pepelsbey left a comment

pepelsbey Jan 31, 2025

chore(ia): reorg Web/Media #37898

Are you sure you want to change the base?

chore(ia): reorg Web/Media #37898

Conversation

bsmth commented Jan 31, 2025

Description

Motivation

github-actions bot commented Jan 31, 2025 • edited Loading

github-actions bot commented Jan 31, 2025

pepelsbey left a comment

Choose a reason for hiding this comment

pepelsbey Jan 31, 2025

Choose a reason for hiding this comment

github-actions bot commented Jan 31, 2025 •

edited

Loading