Skip to content

Editorial review: Document WebGPU compatibility mode#43944

Merged
chrisdavidmills merged 7 commits intomdn:mainfrom
chrisdavidmills:webgpu-compatibility-mode
May 5, 2026
Merged

Editorial review: Document WebGPU compatibility mode#43944
chrisdavidmills merged 7 commits intomdn:mainfrom
chrisdavidmills:webgpu-compatibility-mode

Conversation

@chrisdavidmills
Copy link
Copy Markdown
Contributor

Description

Chrome 146 adds support for WebGPU compatibility mode; see https://chromestatus.com/feature/6436406437871616, and also see https://developer.chrome.com/blog/new-in-webgpu-146#support_webgpu_compatibility_mode_on_opengl_es_31 for more info and context.

This PR:

  • Documents the featureLevel option of the GPU.requestAdapter() method, which is used to opt in to compatibility mode.
  • Updates the description of the core-features-and-limits feature on the GPUSupportedFeatures so that it makes more sense now compatibility mode is supported.
  • Adds a small section on compatibility mode to the WebGPU landing page, as it seems like quite an important concept to draw attention to.

cc @beaufortfrancois

Motivation

Additional details

Related issues and pull requests

@chrisdavidmills chrisdavidmills requested a review from a team as a code owner April 27, 2026 14:33
@chrisdavidmills chrisdavidmills requested review from hamishwillee and removed request for a team April 27, 2026 14:33
@github-actions github-actions Bot added the Content:WebAPI Web API docs label Apr 27, 2026
@chrisdavidmills chrisdavidmills changed the title Document WebGPU compatibility mode Technical review: Document WebGPU compatibility mode Apr 27, 2026
@github-actions github-actions Bot added the size/m [PR only] 51-500 LoC changed label Apr 27, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 27, 2026

Preview URLs (3 pages)

External URLs (3)

URL: /en-US/docs/Web/API/GPUSupportedFeatures
Title: GPUSupportedFeatures


URL: /en-US/docs/Web/API/WebGPU_API
Title: WebGPU API

(comment last updated: 2026-05-05 07:21:18)

Copy link
Copy Markdown
Contributor

@beaufortfrancois beaufortfrancois left a comment

Choose a reason for hiding this comment

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

LGTM

@chrisdavidmills chrisdavidmills changed the title Technical review: Document WebGPU compatibility mode Editorial review: Document WebGPU compatibility mode Apr 28, 2026
Comment thread files/en-us/web/api/gpu/requestadapter/index.md Outdated
Comment thread files/en-us/web/api/webgpu_api/index.md Outdated
Comment thread files/en-us/web/api/gpusupportedfeatures/index.md Outdated
Copy link
Copy Markdown
Collaborator

@hamishwillee hamishwillee left a comment

Choose a reason for hiding this comment

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

Comment thread files/en-us/web/api/gpu/requestadapter/index.md Outdated
Copy link
Copy Markdown
Collaborator

@hamishwillee hamishwillee left a comment

Choose a reason for hiding this comment

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

Just a nit https://github.com/mdn/content/pull/43944/changes#r3178932791 - I'll leave you to decide if it needs fixing, but not blocking approval (your fixes to my last comments look good thanks)

@chrisdavidmills chrisdavidmills merged commit 19b8981 into mdn:main May 5, 2026
9 checks passed
@chrisdavidmills chrisdavidmills deleted the webgpu-compatibility-mode branch May 5, 2026 07:21
pepelsbey added a commit to pepelsbey/mdn-content that referenced this pull request May 6, 2026
* upstream/main: (150 commits)
  PWA relative links (mdn#43953)
  feat(jsondata): add `external_link` translation key (mdn#43978)
  Clarify when var() falls back to its second argument (mdn#44015)
  Correct incorrect filename on learn assessment (mdn#44012)
  FF151 Relnote CanvasRenderingContext2D.lang (mdn#44010)
  FF151: Update container style queries support (mdn#44002)
  Firefox experimental features clean-up (mdn#43887)
  FF151 Relnote: shadowrootslotassignment (mdn#43881)
  Editorial review: Document WebGPU compatibility mode (mdn#43944)
  Correction of solution (mdn#44001)
  Synchronize with BCD v7.3.14 (mdn#44007)
  Editorial review: Document texture_and_sampler_let WGSL feature (mdn#43768)
  Editorial review: Document NavigationTransition.committed (mdn#43692)
  Update window.open on document / window creation and load behavior (mdn#43913)
  FF151 Relnote: keyboardLock option for Element.requestFullScreen() (mdn#43883)
  FF118 keyboard value for Window Event tidy (mdn#43942)
  Bump yaml from 2.8.3 to 2.8.4 (mdn#44005)
  Rename Stylesheet glossary definition to Style sheet (mdn#43997)
  Clarify else-if evaluation order (mdn#43917)
  chore(dictionaries): add technical terms flagged by spelling check (mdn#43907)
  ...

# Conflicts:
#	files/en-us/web/api/svgscriptelement/async/index.md
#	files/en-us/web/api/svgscriptelement/index.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:WebAPI Web API docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants