[Markdown] Convert Web/Media to Markdown - DO NOT SQUASH MERGE #9818

wbamberg · 2021-10-15T00:07:07Z

This PR converts https://developer.mozilla.org/en-US/docs/Web/Media to Markdown.

Preparation PR: #9809.

Conversion report summary:

All unhandled elements

tr (676)
th[scope="row"] (628)
table.standard-table (103)
td (77)
th[scope="col"] (60)
td[style="vertical-align: top;"] (47)
th[rowSpan="2"][scope="row"][style="vertical-align: bottom;"] (16)
th[colSpan="4"][scope="col"][style="text-align: center;"] (15)
td[style="vertical-align: top; border-right: 2px solid #d4dde4;"] (10)
th[scope="row"][style="vertical-align: top;"] (7)
th[rowSpan="2"][scope="row"] (4)
th[scope="col"][style="vertical-align: bottom;"] (4)
table.standard-table[style="max-width: 42rem;"] (4)
td[rowSpan="2"][style="vertical-align: top;"] (3)
th[scope="col"][style="width: 216px;"] (3)
table.standard-table[style="margin-left: 4em; max-width: 30em;"] (2)
th[scope="col"][style="vertical-align: bottom; border-right: 2px solid #d4dde4;"] (2)
th[colSpan="3"][scope="col"][style="text-align: center; border-right: 2px solid #d4dde4;"] (1)
th[colSpan="3"][scope="col"][style="text-align: center;"] (1)
th[scope="row"][style="vertical-align: bottom;"] (1)
th[rowSpan="2"][scope="row"][style="vertical-align: top;"] (1)
th[colSpan="3"][style="font: italic 0.9em Arial, x-locale-body, sans-serif; vertical-align: middle;"] (1)
table.standard-table[style="max-width: 46em;"] (1)

Full conversion report: https://gist.github.com/wbamberg/fdf49a295a131dee7fa70aa16f6d9a2d

...these pages contain a lot of rather complicated tables, which are not getting converted. Apart form tables there are zero unconverted elements.

Apart from the usual randomness, the main changes here are:

removing elements like <a id="AAC"></a>, that are used to provide link targets, and updating any links that use those targets to use heading IDs instead.
removing elements like <a name="aac-foot-1">[1]</a>, that are used to provide targets for footnotes linked from the tables, and doing something else with the footnote (usually just copying it into the table).

After this PR there will be lots of unconverted tables, but nothing else.

There is good content in this bit of the docs, but I think it would be much more approachable if it were split up into more pages.

github-actions · 2021-10-15T00:08:57Z

Preview URLs

Flaws

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

URL: /en-US/docs/Web/Media/Autoplay_guide
Title: Autoplay guide for media and Web Audio APIs
on GitHub
Flaw count: 1

macros:
- /en-US/docs/Web/API/HTMLMediaElement/allowedToPlay does not exist

URL: /en-US/docs/Web/Media/Formats/WebRTC_codecs
Title: Codecs used by WebRTC
on GitHub
Flaw count: 3

macros:
- /en-US/docs/Web/API/MediaStreamTrack/track does not exist
- /en-US/docs/Web/API/RTCRtpParameters/codecs does not exist
- /en-US/docs/Web/API/RTCRtpCodecParameters/payloadType does not exist

External URLs

URL: /en-US/docs/Web/Media
Title: Web media technologies
on GitHub

No new external URLs

URL: /en-US/docs/Web/Media/Autoplay_guide
Title: Autoplay guide for media and Web Audio APIs
on GitHub

https://developer.chrome.com/blog/autoplay/ (1 time) (Note! This may be a new URL 👀)
https://webkit.org/blog/7734/auto-play-policy-changes-for-macos/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/images
Title: Using images in HTML
on GitHub

No new external URLs

URL: /en-US/docs/Web/Media/images/aspect_ratio_mapping
Title: Mapping the width and height attributes of media container elements to their aspect-ratio
on GitHub

https://drafts.csswg.org/css-sizing-4/ (1 time) (Note! This may be a new URL 👀)
https://github.com/WICG/intrinsicsize-attribute (1 time) (Note! This may be a new URL 👀)
A more elegant and easier to use solution WICG/intrinsicsize-attribute#16 (1 time) (Note! This may be a new URL 👀)
https://www.smashingmagazine.com/2019/03/aspect-ratio-unit-css/ (1 time) (Note! This may be a new URL 👀)
https://www.smashingmagazine.com/2020/03/setting-height-width-images-important-again/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/DASH_Adaptive_Streaming_for_HTML_5_Video
Title: DASH Adaptive Streaming for HTML 5 Video
on GitHub

🚨 http://wiki.webmproject.org/adaptive-streaming/instructions-to-playback-adaptive-webm-using-dash (1 time) (Note! This may be a new URL 👀)
🚨 http://wiki.webmproject.org/adaptive-streaming/webm-dash-specification (1 time) (Note! This may be a new URL 👀)
https://bugzilla.mozilla.org/show_bug.cgi?id=778617 (1 time) (Note! This may be a new URL 👀)
https://dashif.org/ (1 time) (Note! This may be a new URL 👀)
https://www.ffmpeg.org/ (1 time) (Note! This may be a new URL 👀)
https://www.w3.org/TR/media-source/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/Formats
Title: Media type and format guide: image, audio, and video content
on GitHub

No new external URLs

URL: /en-US/docs/Web/Media/Formats/WebRTC_codecs
Title: Codecs used by WebRTC
on GitHub

https://datatracker.ietf.org/doc/html/rfc6184 (3 times) (Note! This may be a new URL 👀)
https://support.mozilla.org/en-US/kb/firefox-android-openh264 (1 time) (Note! This may be a new URL 👀)
https://www.itu.int/rec/T-REC-G.711-198811-I/en (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/Formats/Audio_concepts
Title: Digital audio concepts
on GitHub

No new external URLs

URL: /en-US/docs/Web/Media/Formats/Containers
Title: Media container formats (file types)
on GitHub

https://developer.apple.com/library/archive/documentation/QuickTime/QTFF/QTFFPreface/qtffPreface.html (1 time) (Note! This may be a new URL 👀)
https://docs.microsoft.com/en-us/windows/desktop/xaudio2/resource-interchange-file-format--riff- (1 time) (Note! This may be a new URL 👀)
https://en.flossmanuals.net/ogg-theora/ (1 time) (Note! This may be a new URL 👀)
https://matroska.org/technical/specs/index.html (1 time) (Note! This may be a new URL 👀)
https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1441 (1 time) (Note! This may be a new URL 👀)
https://w3c.github.io/media-source/webm-byte-stream-format.html (1 time) (Note! This may be a new URL 👀)
https://web.archive.org/web/20090417165828/http://www.kk.iij4u.or.jp/~kondo/wave/mpidata.txt (1 time) (Note! This may be a new URL 👀)
https://www.apple.com/ (1 time) (Note! This may be a new URL 👀)
https://www.iso.org/standard/19180.html (1 time) (Note! This may be a new URL 👀)
https://www.iso.org/standard/53943.html (1 time) (Note! This may be a new URL 👀)
https://www.iso.org/standard/55688.html (1 time) (Note! This may be a new URL 👀)
https://www.iso.org/standard/74427.html (1 time) (Note! This may be a new URL 👀)
https://www.iso.org/standard/75929.html (1 time) (Note! This may be a new URL 👀)
https://www.microsoft.com/store/productId/9N5TDP8VCMHS (2 times) (Note! This may be a new URL 👀)
https://www.webmproject.org/docs/container/ (1 time) (Note! This may be a new URL 👀)
https://www.xiph.org/ (1 time) (Note! This may be a new URL 👀)
https://xiph.org/flac/format.html (1 time) (Note! This may be a new URL 👀)
https://xiph.org/ogg/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/Formats/Support_issues
Title: Handling media support issues in web content
on GitHub

No new external URLs

URL: /en-US/docs/Web/Media/Formats/Video_codecs
Title: Web video codec guide
on GitHub

🚨 http://hevc.info/ (1 time) (Note! This may be a new URL 👀)
https://about.att.com/innovation/ip/patents/mpeg-4 (1 time) (Note! This may be a new URL 👀)
https://aomedia.org/ (2 times) (Note! This may be a new URL 👀)
https://aomediacodec.github.io/av1-spec/ (6 times) (Note! This may be a new URL 👀)
https://aomediacodec.github.io/av1-spec/av1-spec.pdf (1 time) (Note! This may be a new URL 👀)
https://dev.opera.com/articles/view/introduction-html5-video/ (1 time) (Note! This may be a new URL 👀)
https://en.flossmanuals.net/ogg-theora/ (1 time) (Note! This may be a new URL 👀)
https://en.wikipedia.org/wiki/Discrete_cosine_transform (10 times) (Note! This may be a new URL 👀)
https://en.wikipedia.org/wiki/H.262/MPEG-2_Part_2 (1 time) (Note! This may be a new URL 👀)
https://en.wikipedia.org/wiki/Hybrid_Log-Gamma (2 times) (Note! This may be a new URL 👀)
https://en.wikipedia.org/wiki/ISO/IEC_base_media_file_format (1 time) (Note! This may be a new URL 👀)
https://en.wikipedia.org/wiki/Moir%C3%A9_pattern (1 time) (Note! This may be a new URL 👀)
https://en.wikipedia.org/wiki/Motion_compensation (2 times) (Note! This may be a new URL 👀)
https://en.wikipedia.org/wiki/Perceptual_Quantizer (1 time) (Note! This may be a new URL 👀)
https://mpeg.chiariglione.org/ (5 times) (Note! This may be a new URL 👀)
https://mpeg.chiariglione.org/standards/mpeg-4/advanced-video-coding (1 time) (Note! This may be a new URL 👀)
https://msdn.microsoft.com/en-us/library/ff975061%28v=vs.85%29.aspx (1 time) (Note! This may be a new URL 👀)
https://msdn.microsoft.com/en-us/library/ff975073%28v=VS.85%29.aspx (1 time) (Note! This may be a new URL 👀)
https://www.chromium.org/audio-video (1 time) (Note! This may be a new URL 👀)
https://www.google.com/ (2 times) (Note! This may be a new URL 👀)
https://www.iso.org/standard/22411.html (1 time) (Note! This may be a new URL 👀)
https://www.iso.org/standard/61152.html (1 time) (Note! This may be a new URL 👀)
https://www.iso.org/standard/69668.html (1 time) (Note! This may be a new URL 👀)
https://www.itu.int/ (2 times) (Note! This may be a new URL 👀)
https://www.itu.int/ITU-T/recommendations/related_ps.aspx?id_prod=4242 (1 time) (Note! This may be a new URL 👀)
https://www.itu.int/rec/T-REC-H.262 (1 time) (Note! This may be a new URL 👀)
https://www.itu.int/rec/T-REC-H.263/ (1 time) (Note! This may be a new URL 👀)
https://www.itu.int/rec/T-REC-H.264 (1 time) (Note! This may be a new URL 👀)
https://www.itu.int/rec/T-REC-H.265 (1 time) (Note! This may be a new URL 👀)
https://www.itu.net/ (2 times) (Note! This may be a new URL 👀)
https://www.microsoft.com/en-us/p/web-media-extensions/9n5tdp8vcmhs?activetab=pivot:overviewtab (1 time) (Note! This may be a new URL 👀)
https://www.mpegla.com/ (1 time) (Note! This may be a new URL 👀)
https://www.mpegla.com/programs/avc-h-264/ (2 times) (Note! This may be a new URL 👀)
https://www.mpegla.com/programs/hevc/ (2 times) (Note! This may be a new URL 👀)
https://www.mpegla.com/programs/mpeg-2/ (1 time) (Note! This may be a new URL 👀)
https://www.mpegla.com/programs/mpeg-4-visual/ (1 time) (Note! This may be a new URL 👀)
https://www.theora.org/doc/ (1 time) (Note! This may be a new URL 👀)
https://www.videolan.org/developers/x264.html (1 time) (Note! This may be a new URL 👀)
https://www.webmproject.org/vp9/ (1 time) (Note! This may be a new URL 👀)
https://www.xiph.org/ (1 time) (Note! This may be a new URL 👀)
https://xiph.org/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/Formats/Video_concepts
Title: Digital video concepts
on GitHub

No new external URLs

URL: /en-US/docs/Web/Media/Formats/Image_types
Title: Image file type and format guide
on GitHub

🚨 http://www.ercim.org/ (2 times) (Note! This may be a new URL 👀)
🚨 http://www.lcs.mit.edu/ (2 times) (Note! This may be a new URL 👀)
https://aomediacodec.github.io/av1-avif/ (1 time) (Note! This may be a new URL 👀)
https://aomediacodec.github.io/av1-spec/av1-spec.pdf (1 time) (Note! This may be a new URL 👀)
https://bugzil.la/895131 (1 time) (Note! This may be a new URL 👀)
https://crbug.com/791658 (1 time) (Note! This may be a new URL 👀)
https://creativecommons.org/licenses/by-sa/3.0/ (2 times) (Note! This may be a new URL 👀)
https://developer.apple.com/stickers/ (1 time) (Note! This may be a new URL 👀)
https://developer.apple.com/videos/play/wwdc2020/10663/?time=1174 (1 time) (Note! This may be a new URL 👀)
https://developers.google.com/speed/webp/docs/riff_container (1 time) (Note! This may be a new URL 👀)
https://developers.google.com/speed/webp/docs/webp_lossless_bitstream_specification (1 time) (Note! This may be a new URL 👀)
https://docs.microsoft.com/en-us/openspecs/dev_center/ms-devcentlp/1c24c7c8-28b0-4ce1-a47d-95fe1ff504bc (1 time) (Note! This may be a new URL 👀)
https://docs.microsoft.com/en-us/windows/desktop/gdi/bitmap-storage (1 time) (Note! This may be a new URL 👀)
https://ev.buaa.edu.cn/ (1 time) (Note! This may be a new URL 👀)
https://gif.ski/ (1 time) (Note! This may be a new URL 👀)
https://jpeg.org/jpeg/ (1 time) (Note! This may be a new URL 👀)
https://wiki.mozilla.org/APNG_Specification (1 time) (Note! This may be a new URL 👀)
https://www.adobe.io/open/standards/TIFF.html (1 time) (Note! This may be a new URL 👀)
https://www.ctrl.blog/entry/webp-avif-comparison.html (1 time) (Note! This may be a new URL 👀)
https://www.keio.ac.jp/ (2 times) (Note! This may be a new URL 👀)
https://www.w3.org/ (2 times) (Note! This may be a new URL 👀)
https://www.w3.org/Consortium/Legal/copyright-documents (2 times) (Note! This may be a new URL 👀)
https://www.w3.org/Consortium/Legal/copyright-software (2 times) (Note! This may be a new URL 👀)
https://www.w3.org/Consortium/Legal/ipr-notice (4 times) (Note! This may be a new URL 👀)
https://www.w3.org/Graphics/GIF/spec-gif87.txt (1 time) (Note! This may be a new URL 👀)
https://www.w3.org/Graphics/GIF/spec-gif89a.txt (1 time) (Note! This may be a new URL 👀)
https://www.w3.org/TR/PNG (1 time) (Note! This may be a new URL 👀)
https://www.w3.org/TR/PNG/ (3 times) (Note! This may be a new URL 👀)
https://www.w3.org/TR/SVG2 (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/Formats/Audio_codecs
Title: Web audio codec guide
on GitHub

🚨 http://lame.sourceforge.net/ (1 time) (Note! This may be a new URL 👀)
🚨 http://www.voiceage.com/AMR-NB.AMR.html (1 time) (Note! This may be a new URL 👀)
🚨 http://www.voiceage.com/Overview-lic.html (1 time) (Note! This may be a new URL 👀)
https://brew.sh/ (1 time) (Note! This may be a new URL 👀)
https://ffmpeg.org/ (1 time) (Note! This may be a new URL 👀)
https://github.com/macosforge/alac (1 time) (Note! This may be a new URL 👀)
https://gstreamer.freedesktop.org/ (2 times) (Note! This may be a new URL 👀)
https://handbrake.fr/ (1 time) (Note! This may be a new URL 👀)
https://www.apple.com/itunes (1 time) (Note! This may be a new URL 👀)
https://www.audacityteam.org/ (1 time) (Note! This may be a new URL 👀)
https://www.ietf.org/ (1 time) (Note! This may be a new URL 👀)
https://www.iso.org/standard/22412.html (1 time) (Note! This may be a new URL 👀)
https://www.iso.org/standard/26797.html (1 time) (Note! This may be a new URL 👀)
https://www.iso.org/standard/43345.html (1 time) (Note! This may be a new URL 👀)
https://www.iso.org/standard/53943.html (1 time) (Note! This may be a new URL 👀)
https://www.via-corp.com/licensing/aac/ (1 time) (Note! This may be a new URL 👀)
https://www.xiph.org/vorbis/ (1 time) (Note! This may be a new URL 👀)
https://xiph.org/ (2 times) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/Formats/codecs_parameter
Title: The "codecs" parameter in common media types
on GitHub

https://aomediacodec.github.io/av1-isobmff (1 time) (Note! This may be a new URL 👀)
https://aomediacodec.github.io/av1-isobmff/ (1 time) (Note! This may be a new URL 👀)
https://aomediacodec.github.io/av1-spec/ (2 times) (Note! This may be a new URL 👀)
https://github.com/w3c/webrtc-svc (1 time) (Note! This may be a new URL 👀)
https://mp4ra.org/ (3 times) (Note! This may be a new URL 👀)
https://www.iso.org/standard/54838.html (2 times) (Note! This may be a new URL 👀)
https://www.itu.int/rec/T-REC-H.273/en (3 times) (Note! This may be a new URL 👀)
https://www.webmproject.org/vp9/mp4 (1 time) (Note! This may be a new URL 👀)
https://www.webmproject.org/vp9/mp4/ (1 time) (Note! This may be a new URL 👀)

URL: /en-US/docs/Web/Media/Streaming
Title: Guide to streaming audio and video
on GitHub

No new external URLs

URL: /en-US/docs/Web/Media/HTML_media
Title: Using audio and video in HTML
on GitHub

No new external URLs

(this comment was updated 2021-10-15 17:44:10.028940)

Rumyra

Added a couple of amends but it all looks good to me

wbamberg added 2 commits October 14, 2021 16:45

Rename HTML files to MD

0bbc6dd

Convert file contents to Markdown

f5e9f2b

wbamberg requested a review from a team as a code owner October 15, 2021 00:07

wbamberg requested review from Rumyra and removed request for a team October 15, 2021 00:07

github-actions bot added the Content:Media Media docs label Oct 15, 2021

couple of small things

07d4a78

Rumyra approved these changes Oct 15, 2021

View reviewed changes

Rumyra merged commit a188202 into mdn:main Oct 15, 2021

wbamberg deleted the media-to-markdown branch October 15, 2022 17:22

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[Markdown] Convert Web/Media to Markdown - DO NOT SQUASH MERGE #9818

[Markdown] Convert Web/Media to Markdown - DO NOT SQUASH MERGE #9818

wbamberg commented Oct 15, 2021

github-actions bot commented Oct 15, 2021 •

edited

Loading

Rumyra left a comment

[Markdown] Convert Web/Media to Markdown - DO NOT SQUASH MERGE #9818

[Markdown] Convert Web/Media to Markdown - DO NOT SQUASH MERGE #9818

Conversation

wbamberg commented Oct 15, 2021

All unhandled elements

github-actions bot commented Oct 15, 2021 • edited Loading

Preview URLs

Flaws

External URLs

Rumyra left a comment

Choose a reason for hiding this comment

github-actions bot commented Oct 15, 2021 •

edited

Loading