https://github.com/microsoftedge/msedgeexplainers
Home for explainer documents originated by the Microsoft Edge team
https://github.com/microsoftedge/msedgeexplainers
explainer microsoft-edge standards webplatform
Last synced: 6 months ago
JSON representation
Home for explainer documents originated by the Microsoft Edge team
- Host: GitHub
- URL: https://github.com/microsoftedge/msedgeexplainers
- Owner: MicrosoftEdge
- License: cc-by-4.0
- Created: 2018-12-06T00:30:17.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2025-03-20T23:35:34.000Z (7 months ago)
- Last Synced: 2025-03-21T00:27:07.758Z (7 months ago)
- Topics: explainer, microsoft-edge, standards, webplatform
- Language: HTML
- Homepage:
- Size: 82.5 MB
- Stars: 1,334
- Watchers: 129
- Forks: 223
- Open Issues: 138
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Microsoft Edge Explainers
Welcome! This repo is home to "explainers" and related documents originating
from the Microsoft Edge team.
#### Jump to section: [Active Explainers](#active-explainers-) | [Alumni](#alumni-) | [DevTools](https://github.com/MicrosoftEdge/DevTools/tree/main/explainers) | [Other documents](#other-documents) | [Withdrawn](#withdrawn)
## Introduction
[Explainers](https://tag.w3.org/explainers/) are documents focused on
describing a user/ developer/ customer problem (at a high level) and exploring
potential solutions. These documents are starting points for engaging in discussion
with you and other members of the community. Explainers should address their
stated problems in clear and easy to understand language. Proposed solutions
should be easy to follow and not too deep in technical details. When you read
an explainer, we hope the stated problem is compelling and you can form an
opinion for whether the proposed solution would address the problem.
### Please provide feedback
We are looking for feedback! Are the stated problems relevant to you?
How have they impacted your experience? Do the proposed solutions seem reasonable?
Do they follow good [web principles](https://w3ctag.github.io/design-principles/)?
Would they solve a problem you currently have? (We love to hear that; tell
us more about your scenario!) Do you have related use-cases we hadn't considered?
We appreciate you taking the time to offer feedback; it helps to improve the
explainers, validate the problem and solutions they describe, and show evidence
that there is potential momentum to move an idea to the next stage. We desire
to see all our explainers make the journey to become cross-browser supported
web standards.
**[Start a new issue here](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new)**,
or [join in the discussion](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/)
on existing issues. We also welcome PRs on the explainer documents themselves.
Note: we use labels to filter the issues to specific explainers.
### Have a product bug?
If you're looking to file a product bug on Microsoft Edge and the bug is unique
to Edge, please use the in-browser "Send Feedback" tool (Alt+Shift+i in Windows,
or "..." > "Help and feedback"). If the bug reproduces in another Chromium-based
browser, please file the issue upstream in the [Chromium bug database](https://bugs.chromium.org/p/chromium/).
Thanks!
# Active Explainers 📣
These are the proposals we are currently investigating in this repo. Use the
links below to read the explainers, review the current issues, and file new
issues specifically for the given explainer(s). We hope they will all "graduate"
and begin their journey along the standards-track as they gain sufficient interest;
each explainer has a "status of this document" section that indicates
what standards venue they expect to go to next (if known). When they graduate,
we move them into the [Alumni section](#alumni-) below.
| Explainer | Issues | Feedback | Group |
| --------- | ------ | -------- | -------- |
| [CSS Gap Decorations](CSSGapDecorations/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=kbabbitt&labels=CSSGapDecorations&template=css-gap-decorations.md&title=%5BCSS+Gap+Decorations%5D+%3CTITLE+HERE%3E) | CSS |
| [Enterprise Platform Authentication Broker API](PlatformAuthentication/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=coder-linping&labels=Enterprise%20Platform%20Authentication&template=platform-authentication-api.md&title=%5BPlatform+Authentication+API%5D+%3CTITLE+HERE%3E) | Identity |
| [Handwriting CSS attribute](Handwriting/HandwritingIntentCSSValue.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=adettenb&labels=Handwriting&template=Handwriting.md&title=%5BHandwriting%5D+Issue) | CSS |
| [Pen Events](PenEvents/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=BoCupp-Microsoft%2C+gked&labels=Pen+Events&template=pen-events.md&title=%5BPenEvents%5D+%3CTITLE+HERE%3E) | Editing |
| [Pen Action](PenAction/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=BoCupp-Microsoft%2C+gked&labels=Pen+Action&template=pen-action.md&title=%5Bpen-action%5D+%3CTITLE+HERE%3E) | Editing |
| [Delayed Clipboard Rendering](DelayedClipboard/DelayedClipboardRenderingExplainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=anaskim&labels=Delayed+Clipboard+Rendering&template=delayed-clipboard-rendering.md&title=%5BDelayed+Clipboard+Rendering%5D+%3CTITLE+HERE%3E) | Editing |
| [Iframe Media Playback Pause](IframeMediaPause/iframe_media_pausing.md) |  | [New Issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=gabrielbrito&labels=Iframe+Media+Playback+Pause&title=%5BIframe+Media+Playback+Pause%5D+%3CTITLE+HERE%3E) | HTML |
| [Source Hashes in Stack Traces](DevTools/SourceHash/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=robpaveza&labels=Source+hash&title=%5BSource+Hashes%5D+%3CTITLE+HERE%3E) | JavaScript |
| [Call Stacks in Crash Reports](CrashReporting/AddStackToCrashReports.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=issackjohn&labels=Call+stacks+in+crash+reports&template=call-stacks-in-crash-reports.md&title=%5BCall+Stacks+In+Crash+Reports%5D+%3CTITLE+HERE%3E) | Performance |
| [PerformanceNavigationTiming User Agent Launch](PerformanceNavigationTiming%20for%20User%20Agent%20Launch/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=dylank%2C+hemingzh&labels=Perf+timing+during+browser+start&template=performance-timing-during-browser-start.md&title=%5BPerf+Timing+during+launch%5D+%3CTITLE+HERE%3E) | Performance |
| [Trust Token Issuer Redemption Statistics](TrustTokenExtensions/IssuerRedemptionStatistics.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=Brandr0id%2C+erik-anderson&labels=Trust+Token+Issuer+Redemption+Statistics&template=trust-token-issuer-redemption-statistics.md&title=%5BTrust+Token+Issuer+Redemption+Statistics%5D+%3CTITLE+HERE%3E) | Privacy |
| [Browser Binding Context](BindingContext/explainer.md) |  | [New issue....](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=sameerag&labels=Browser+Binding+Context+BPoP&template=browser-binding-context-bpop.md&title=%5Browser+Binding+Context+BPoP%5D+%3CTITLE+HERE%3E) | Privacy |
| [Acquisition Info](AcquisitionInfo/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=kyerebo&labels=Acquisition+Info&template=acquisition-info.md&title=%5BAcquisition+Info%5D+%3CTITLE+HERE%3E) | PWA |
| [ApplicationData.LocalFolder Access](LocalFolder/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=luhuangMSFT&labels=LocalFolder+Access&template=local-folder-access.md&title=%5BLocalFolder+Access%5D+%3CTITLE+HERE%3E) | PWA |
| [Document Subtitle](DocumentSubtitle/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=diekus&labels=Document+Subtitle&template=document-subtitle.md&title=%5BDocument+Subtitle%5D+%3CTITLE+HERE%3E) | PWA |
| [Ratings & Reviews Prompt](RatingsAndReviewsPrompt/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=aarongustafson%2C+diekus&labels=Ratings+and+Reviews&template=ratings-and-reviews-prompt.md&title=%5BRatings+and+Reviews+Prompt%5D+%3CTITLE+HERE%3E) | PWA |
| [System Status Icon for installed web apps](SystemStatusIcon/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=diekus&labels=System+Status+Icon&template=systray-icon.md&title=%5BSystem+Status+Icon%5D+%3CTITLE+HERE%3E) | PWA |
| [URL Protocol Handler Registration for PWAs](URLProtocolHandler/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=fabiorocha%2C+connor-moody%2C+samtan-msft&labels=URLProtocolHandler&template=url-protocol-handler-registration.md&title=%5BURL+Protocol+Handler+Registration%5D+%3CTITLE+HERE%3E) | PWA |
| [Web Install API](WebInstall/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=diekus&labels=Web+Install+API&template=web-install-api.md&title=%5BWeb+Install%5D+%3CTITLE+HERE%3E) | PWA |
| [Widgets](PWAWidgets/README.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=aarongustafson&labels=PWA+Widgets&template=pwa-widgets.md&title=%5BPWA+Widgets%5D+%3CTITLE+HERE%3E) | PWA |
| [Calling Notifications](Notifications/notifications_actions_customization.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=jungkees%2C+gabrielsanbrito%2C+SteveBeckerMSFT&labels=Calling+Notifications&template=calling-notifications.md&title=%5BCalling+Notifications%5D+%3CTITLE+HERE%3E) | Web Applications |
| [Web Haptics API](https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/HapticsDevice/explainer.md) |  | [New Issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=bmathwig&labels=HapticsDevice+API&template=hapticsdevice-api.md&title=%5BHapticsDevice%5D+Issue) | Web Applications |
| [Split Tab Navigation](https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/SplitTab/NavigationInSplitTab/explainer.md) |  | [New Issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=xuzhengyi1995&labels=Split+Tab&template=split-tab.md&title=%Split+Tab%5D+Issue) | Web Applications |
| [Set Default Audio Output Device](SetPreferredSinkId/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=sunggch&labels=SetPreferredSinkId&template=setPreferredSinkId.md&title=%5BSetPreferredSinkId%5D+Issue) | WebRTC |
| [Handwriting attribute](Handwriting/explainer.md) |  | [New issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=adettenb&labels=Handwriting&template=Handwriting.md&title=%5BHandwriting%5D+Issue) | HTML |
| [AudioContext Interrupted State](https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/AudioContextInterruptedState/explainer.md) |  | [New Issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=gabrielbrito&labels=AudioContext+Interrupted+State&title=%5BAudioContext+Interrupted+State%5D+%3CTITLE+HERE%3E) | WebAudio |
| [IndexedDB getAllRecords()](https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/IndexedDbGetAllEntries/explainer.md) |  | [New Issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=SteveBeckerMSFT&labels=IndexedDB%20GetAllRecords&title=%5BIndexedDB+getAllRecords()%5D+%3CTITLE+HERE%3E) | IndexedDB |
| [Mulitple Stylesheets Per File (@sheet)](https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/AtSheet/explainer.md) |  | [New Issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=aluhrs13&labels=AtSheet&title=%5B%40sheet%5D+%3CTITLE+HERE%3E) | CSS |
| [Link Rel Local Reference](https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/LocalReferenceLinkRel/explainer.md) |  | [New Issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=KurtCattiSchmidt&labels=LRLR&title=%5BLRLR%5D+%3CTITLE+HERE%3E) | HTML |
# Brainstorming 🧠
These are proposals that are still really early in their lifecycle. We might just be thinking about the problems, starting to get rough ideas of what solutions might look like, or just want to throw an idea out to the world to see if there's more people with similar problems. Once we get a handle on the possible solutions and directions we'll move these to the "Active Explainers" section above.
| Explainer | Issues | Feedback | Group |
| ---- | ---- | ---- | ---- |
| [Performance Control of Embedded Content](https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/PerformanceControlOfEmbeddedContent/explainer.md) |  | [New Issue...](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?assignees=nishitha-burman&labels=PerformanceControlOfEmbeddedContent&title=%5BPerformanceControlOfEmbeddedContent%5D+%3CTITLE+HERE%3E) | Web Perf |
# Alumni 🎓
Awesome! These explainers have moved on to bigger and better things! We've
archived the original explainers here for posterity and updated their document
status section to help you find where the latest discussions are happening.
Please continue to participate and follow the links below to the current
standards communities. Thanks for your continued interest!
| Current Explainer | Current Venue | Archive link and date |
|---|---|---|
| [CSS Anchored Positioning](https://drafts.csswg.org/css-anchor-1/) | [W3C CSS Working Group](https://www.w3.org/Style/CSS/) | 2022-10-30 |
| [PARAKEET with Noisy Ranking](https://github.com/WICG/privacy-preserving-ads/blob/main/NoisyRanking.md) | [Web Incubator Community Group](https://wicg.io/) | 2022-04-19 |
| [focusgroup for HTML and CSS](https://open-ui.org/components/focusgroup.explainer) | [Open UI Community Group](https://www.w3.org/community/open-ui/) | [2022-04-09](Focusgroup/explainer.md) |
| [Web App Link Handling Manifest Options](https://github.com/WICG/pwa-url-handler/blob/main/handle_links/explainer.md) | [Web Incubator Community Group](https://wicg.io/) | 2021-09-28 |
| [EyeDropper API](https://github.com/WICG/eyedropper-api/blob/main/README.md) | [Web Incubator Community Group](https://wicg.io/) | [2021-08-03](EyeDropper/explainer.md) |
| [Virtual Keyboard Policy](https://www.w3.org/TR/virtual-keyboard/) | [W3C Editing Working Group](https://w3c.github.io/editing/) | [2021-07-29](VirtualKeyboardPolicy/explainer.md) |
| [Masked LARK](https://github.com/WICG/privacy-preserving-ads/blob/main/MaskedLARK.md) | [Web Incubator Community Group](https://wicg.io/) | 2021-07-11 |
| [Accessible Confirmation of Action](https://wicg.github.io/aom/notification-api.html) | [Web Incubator Community Group](https://wicg.io/) | [2021-06-23](Accessibility/ConfirmationOfAction/explainer.md) |
| [MACAW](https://github.com/WICG/privacy-preserving-ads/blob/main/MACAW.md) | [Web Incubator Community Group](https://wicg.io/) | 2021-04-07 |
| [Enabling popups](https://open-ui.org/components/popup.research.explainer) | [Open UI Community Group](https://www.w3.org/community/open-ui/) | [2021-03-22](Popup/explainer.md) |
| [PARAKEET](https://github.com/WICG/privacy-preserving-ads/blob/main/Parakeet.md) | [Web Incubator Community Group](https://wicg.io/) | 2021-03-04 |
| [Virtual Keyboard API](https://www.w3.org/TR/virtual-keyboard/) | [W3C Editing Working Group](https://w3c.github.io/editing/) | [2021-03-02](VirtualKeyboardAPI/explainer.md) |
| [Canvas Formatted Text](https://github.com/WICG/canvas-formatted-text/blob/main/README.md) | [Web Incubator Community Group](https://wicg.io/) | [2020-09-23](Canvas/FormattedText.md) |
| [Window Controls Overlay for Installed Desktop Web Apps](https://github.com/WICG/window-controls-overlay/blob/master/explainer.md) | [Web Incubator Community Group](https://wicg.io/) | [2020-07-08](TitleBarCustomization/explainer.md) |
| [PWAs as URL Handlers](https://github.com/WICG/pwa-url-handler/blob/master/explainer.md) ([updated proposal here](https://github.com/WICG/pwa-url-handler/blob/main/handle_links/explainer.md)) | [Web Incubator Community Group](https://wicg.io/) | [2020-05-28](PwaUriHandler/explainer.md) |
| [EditContext API](https://w3c.github.io/edit-context/) | [W3C Editing Working Group](https://w3c.github.io/editing/) | [2020-03-17](EditContext/explainer.md) |
| [Bidirectional WebDriver Protocol](https://github.com/w3c/webdriver-bidi/blob/master/explainer.md) | [WebDriver incubator of the W3C Browser Testing and Tools Working Group](https://github.com/w3c/webdriver/blob/master/README.md) | [2020-03-13](WebDriverRPC/webdriver.md) |
| [Web Ink Enhancement: Delegated Ink Trail Presentation Aided By The OS](https://github.com/WICG/ink-enhancement/blob/master/README.md) | [Web Incubator Community Group](https://wicg.io/) | [2020-02-27](WebInkEnhancement/explainer.md) |
| [Viewport Segments Property](https://github.com/WICG/visual-viewport/blob/gh-pages/segments-explainer/SEGMENTS-EXPLAINER.md) (formerly [Window Segments Enumeration API](https://github.com/webscreens/window-segments/blob/master/EXPLAINER.md)) | [Web Incubator Community Group](https://wicg.io/) | [2020-02-26](Foldables/explainer.md) |
| [@media queries for HDR video in Media Queries Level 4](https://drafts.csswg.org/mediaqueries-4/#video-prefixed-features) | [W3C CSS Working Group](https://www.w3.org/Style/CSS/) | 2020-01-17 |
| [Improved Client-side Video Editing](https://github.com/WICG/video-editing/blob/master/readme.md) | [Web Incubator Community Group](https://wicg.io/) | [2020-01-08](MediaBlob/explainer.md) |
| [CSS Custom Highlight API Module Level 1](https://drafts.csswg.org/css-highlight-api-1/) | [W3C CSS Working Group](https://www.w3.org/Style/CSS/) | [2019-12-10](highlight/explainer.md) |
| [highlightsFromPoint API](https://drafts.csswg.org/css-highlight-api-1/#interactions) | [W3C CSS Working Group](https://www.w3.org/Style/CSS/) | [2025-01-24](highlight/HighlightsFromPointsExplainer.md)
| [Import Assertions](https://github.com/tc39/proposal-import-assertions/blob/master/README.md) | [ECMA TC39 Task Group](https://www.ecma-international.org/memento/tc39-rf-tg.htm) | 2019-11-08 |
| ['shortcuts' member of Web App Manifest](https://w3c.github.io/manifest/#shortcuts-member) | [W3C Web Applications Working Group](https://www.w3.org/2019/webapps/) | [2019-11-04](Shortcuts/explainer.md) |
| ['spatialRendering' for spatial audio query in Media Capabilities](https://w3c.github.io/media-capabilities/#audioconfiguration) | [W3C Media Working Group](https://www.w3.org/media-wg/) | 2019-10-02 |
| [ARIA Virtual Content](https://github.com/WICG/accessible-loading-and-searching-of-content/blob/main/explainer.md) | [Web Incubator Community Group](https://wicg.io/) |[2019-09-27](Accessibility/VirtualContent/explainer.md) |
| [CSS Modules V1](https://github.com/WICG/webcomponents/blob/gh-pages/proposals/css-modules-v1-explainer.md) | [Web Incubator Community Group](https://wicg.io/) | [2019-08-08](CSSModules/v1Explainer.md) |
| [System Colors section of CSS Color Module Level 4](https://drafts.csswg.org/css-color/#css-system-colors) | [W3C CSS Working Group](https://www.w3.org/Style/CSS/) | [2019-08-05](Accessibility/HighContrast/explainer.md) |
| ['hdrMetadataType' for HDR query in Media Capabilities](https://w3c.github.io/media-capabilities/#videoconfiguration) | [W3C Media Working Group](https://www.w3.org/media-wg/) | 2019-07-29 |
| [Native GLTF proposal](https://github.com/immersive-web/proposals/issues/52) | [W3C Immersive Web Community Group](https://immersive-web.github.io/) | 2019-07-15 |
| [Open UI (Standardized Form Controls)](https://github.com/WICG/open-ui) | [Web Incubator Community Group](https://wicg.io/) | 2019-05-15 |
| ['forced-colors' of Media Queries Level 5](https://drafts.csswg.org/mediaqueries-5/#forced-colors) | [W3C CSS Working Group](https://www.w3.org/Style/CSS/) | [2019-04-19](Accessibility/HighContrast/explainer.md) |
| ['forced-color-adjust' of CSS Color Adjustment Module Level 1](https://drafts.csswg.org/css-color-adjust-1/#forced) | [W3C CSS Working Group](https://www.w3.org/Style/CSS/) | [2019-04-19](Accessibility/HighContrast/explainer.md) |
| [HTML Modules](https://github.com/WICG/webcomponents/blob/gh-pages/proposals/html-modules-explainer.md) | [Web Incubator Community Group](https://wicg.io/) | [2019-02-26](HTMLModules/explainer.md) |
| [CSS color-mix() function](https://drafts.csswg.org/css-color-5/#funcdef-color-mix) | [W3C CSS Working Group](https://www.w3.org/Style/CSS/) | [2023-07-17](CSSColorMix/explainer.md) |
| [Audio Stream Category](https://w3c.github.io/mst-content-hint/#mediastreamtrack-extension) | [W3C Web Real-Time Communications Working Group](https://www.w3.org/groups/wg/webrtc) |[2023-07-17](AudioStreamCategory/explainer.md) |
|[Storage Access API](https://github.com/privacycg/storage-access)|[W3C Privacy Community Group](https://privacycg.github.io/)|[2023-07-17](StorageAccessAPI/explainer.md)|
|[Primitives for Enlightened Experiences on Foldable Devices (CSS parts)](https://github.com/WICG/visual-viewport/blob/gh-pages/segments-explainer/SEGMENTS-EXPLAINER.md)|[Web Incubator Community Group](https://wicg.io/)|[2023-07-17](Foldables/explainer.md)|
| [Exporting IDs from shadow roots for cross-root ARIA](https://github.com/WICG/aom/blob/gh-pages/exportid-explainer.md) | [Web Incubator Community Group](https://wicg.io/) | 2023-09-22 |
| [writingsuggestions attribute](https://html.spec.whatwg.org/#writing-suggestions) | [WHATWG](https://whatwg.org/) | [2024-03-12](WritingSuggestions/explainer.md)
| [PointerEvent DeviceId](https://github.com/WICG/pointer-event-extensions/blob/main/pointer-event-device-id-explainer.md) | [W3C Web Incubator Community Group](https://wicg.io/) | [2024-01-11](PointerEventDeviceId/explainer.md) |
| [Gamepad Trigger Rumble](https://w3c.github.io/gamepad/#dom-gamepadhapticactuator) | [W3C Web Applications Working Group](https://www.w3.org/groups/wg/webapps/) | [2024-04-10](GamepadHapticsActuatorTriggerRumble/explainer.md) |
# DevTools 🧰
⭐Our DevTools explainers have moved to
[their own repo](https://github.com/MicrosoftEdge/DevTools/tree/main/explainers) for improved tracking
and update frequency!⭐
For explainers that were hosted in this repo, an achived copy remains here, and the related explainers
link to their new location.
* [Closeable tabs](https://docs.google.com/document/d/1TC1FxzSgRIaXmChpjL05T7sZuduRos3IDPDG5vCS1Oc/)
* [CSS Grid Tooling](https://docs.google.com/document/d/1s0AkeMOtlwqD74GJZtedxqOnttQtgj9oo8RjfVyaHP8/)
* [Customizable Keyboard Shortcuts](https://docs.google.com/document/d/1oOPSWPxCHvMoBZ0Fw9jwFZt6gP4lrsrsl8DEAp-Hy7o/)
* [Dual-screen Emulation](https://docs.google.com/document/d/1KMsmEXdjmn4h4iIl0n74N1EHxwwNUzh6R2p7GHrdtTI)
* [Focus Mode](https://github.com/MicrosoftEdge/DevTools/blob/main/explainers/FocusMode/explainer.md) ([archive](DevTools/FocusMode/explainer.md))
* [High Contrast Simulation](https://docs.google.com/document/d/1SUx-hfodUUMAIwmcwIVYlpi9YDrLnkwW0T7yXUN8s50/)
* [Infobar UI Refresh](https://docs.google.com/document/d/1GjpfPkdljH97IAaWfY8d9NBim1wrPPRaD8zMl8PWhLs/)
* [Localization](https://docs.google.com/document/d/1L6TkT2-42MMQ72ZSBMFwUaq7M6mDgA2X0x8oHHKaV_U/)
* [Movable tabs](https://docs.google.com/document/d/1S4tLbaK9ukeiK6ew_kU_uiLoVlycN5gineGA05boHK4/)
* [Redux for State](https://docs.google.com/document/d/1yVI-ABz_PL5npfoNosvv1ZKOsXhUwSMKc30UHf2RyqM/)
* [Search Console](https://github.com/MicrosoftEdge/DevTools/blob/main/explainers/SearchConsole/explainer.md) ([archive](DevTools/SearchConsole/explainer.md))
* [Service Worker Improvements](https://docs.google.com/document/d/1L-dhKWYoVECdoqVQ0hOKqtyWbk5LtluFWbZE8PJZtnU/)
* [Settings Discoverability and Telemetry](https://docs.google.com/document/d/1n9AGuh0iWQoqgm749BJJELK-ckrkgnaB5jfgef9RWSA/)
* [Settings Search](https://docs.google.com/document/d/1nRh5Y7JqNOowkOqpbYfJMbSZ1rqSHhRh_7HqzqhuHwY/)
* [Stackable Overlays](https://docs.google.com/document/d/13MHkk0rgHJl_MAIgrouUef5k9fK7lZMI1IEiNIUKbD0/)
* [Updated 3D View](https://github.com/MicrosoftEdge/DevTools/blob/main/explainers/3DView/explainer.md) ([archive](DevTools/3DView/explainer.md), [original](https://docs.google.com/document/d/16xsQbr1YjjuoxHJlCsAaIzK-s4Ogd6fEuhrSajdVivA))
* [webhint](https://github.com/MicrosoftEdge/DevTools/blob/main/explainers/webhint/explainer.md) ([archive](DevTools/webhint/explainer.md))
# Other Documents
A collection of explainers documenting platform enhancements (not web
developer-facing features), implementation designs, and other public documents
related to the construction of Microsoft Edge.
### Accessibility
* [Native Caret Browsing](Accessibility/CaretBrowsing/explainer.md) explainer and [Design Doc](Accessibility/CaretBrowsing/designDoc.md)
* [Tagged PDFs support](PDF/TaggedPDF/explainer.md) explainer
* [UI Automation Provider Mappings](Accessibility/UIA/explainer.md) explainer and [intent-to-implement](Accessibility/UIA/i2i.md)
* [WebVTT Caption Styling](WebVTTCaptionStyling/explainer.md) explainer
### Editing
* [Streamlined Text Input (TSF1)](TSF1/explainer.md) explainer
* [PenEvents](PenEvents/dev-design.md) design document
### Fonts
* [End User Defined Characters (EUDC)](EUDC/explainer.md) explainer
### HTML
* [HTML Modules](HTMLModules/i2i.md) intent-to-prototype
* [JSON Modules](https://groups.google.com/a/chromium.org/forum/#!topic/blink-dev/ojwkySW-bpQ) intent-to-prototype
* [Synthetic Module Record](SyntheticModules/designDoc.md) design document
### Media
* [Hardware-offloaded Audio Processing](AudioOffload/explainer.md) explainer
* [Media Cache Reduction](MediaCacheReduction/explainer.md) explainer
### Privacy
* [Auditing Privacy on the Web](WebPrivacyAuditing/explainer.md) a principles document describing our commitment to privacy through the principles of transparency, control, respect, and protection for our users.
### Testing & Trials
* [Microsoft Edge Origin Trials Guide](OriginTrialsGuide/explainer.md)
### User Interaction
* [Impl Threaded Scrollbar scrolling](https://groups.google.com/a/chromium.org/forum/#!topic/input-dev/6ACOSDoAik4) intent-to-implement
### Web Performance Measurement
* [Frame Timing](FrameTiming/use_cases.md) use cases
# Withdrawn
When at first you don't succeed… don't give up! We're no longer pursuing
the solutions described in these explainers at this time, but that doesn't
mean the problem isn't worth solving. Have an idea for an alternate solution?
We'd love to hear your feedback!
| Explainer | Notes | Date |
|---|---|---|
| [Set and Reset Clip](Canvas/SetAndResetClip.md) | This feature proved technically infeasable during implementation due to shortcoming in the underlying Canvas technology stack, namely that Skia only had a way to restrict clip but not to expand it. Given additional compelling use cases, or changes in the implementation stack, this proposal could be re-considered. | 2022-04-21 |
| [Custom Dialog on Close](Withdrawn/CustomDialogOnClose/explainer.md) | This design conflicted with the philosophy of keeping tab close as fast as possible. Work is ongoing to describe a way to meet the needs that this design aimed to address. | 2020-03-25 |
| [Arbitrary Text Fragments](Fragments/explainer.md) | We are now directing our efforts into providing feedback on the similar proposal [ScrollToTextFragment](https://github.com/WICG/ScrollToTextFragment/) already being incubated in the [W3C Web Incubator Community Group](https://wicg.io/). | 2019-10-31 |
| [Password Reveal](PasswordReveal/explainer.md) | Rather than working on this HTML controls feature in isolation, we have rolled this effort into the larger [Open UI](https://github.com/WICG/open-ui) project of the [Web Incubator Community Group](https://wicg.io/) in an effort to provide a standardized set of form controls for the web, including password. | 2019-06-17 |
| [Range innerText](RangeInnerText/explainer.md) | | 2023-07-17 |
| [Enabling Custom Control UI](ControlUICustomization/explainer.md) | Originally driven by Microsoft, the project has since been handed off to the [Open UI](https://github.com/WICG/open-ui) project and implementation handled by Google | 2023-07-17 |
| [Time-limited Permissions](TimeLimitedPermissions/Explainer.md) | | 2023-07-17 |
| [Cache API Response Metadata](CacheAPIResponseMetadata/explainer.md) | | 2023-07-17 |
| [First Run Permissions Prompt](InstallTimePermissionsPrompt/Explainer.md) | | 2023-07-17 |
| [Version History](VersionHistory/explainer.md) | | 2023-07-17 |
| [Confirmation of Action](Accessibility/ConfimrationOfAction/explainer.md) | This effort is being pursued in a similar proposal, [AriaNotify](Accessibility/AriaNotify/explainer.md)| 2023-11-13 |
| [PerformanceNavigationTiming Protocol Launch](PerformanceNavigationTimingProtocolLaunchExtensions/explainer.md) | | 2024-04-22 |