You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/data-guidelines/README.md
+2-11Lines changed: 2 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,10 +58,6 @@ This guideline was adopted to protect the quality of stable data in the face of
58
58
59
59
## `"partial_implementation"` general usage guidelines
60
60
61
-
> [!NOTE]
62
-
> This guideline was added in August 2025 and feedback is welcome.
63
-
> If you have questions or concerns about how to apply it, [file an issue](https://github.com/mdn/browser-compat-data/issues/new/choose).
64
-
65
61
The partial implementation flag often requires a judgment call.
66
62
If you're not completely certain, ask for a second opinion.
67
63
@@ -95,8 +91,7 @@ Here are some example situations where this guideline may or may not apply:
95
91
96
92
-`"partial_implementation": false`: All implementing browsers provide a form control user interface, but the specification gives the implementer discretion over its look and feel.
97
93
A developer complains that one browser's user interface lacks some desired quality that other browsers implement; they want it to be marked as partially implemented.
98
-
Use a note or non-standard behavioral subfeature instead.
99
-
<!-- TODO: link to behavioral subfeature guidelines, when available -->
94
+
Use a note or non-standard [behavioral subfeature](#behavioral-subfeatures) instead.
100
95
101
96
-`"partial_implementation": false`: An implementing browser fails a web platform test against a corner case.
102
97
No web developers have reported the bug and it's unlikely that there are real-world applications that would attempt to use the corner case.
@@ -220,10 +215,6 @@ This guideline was proposed in [#15703](https://github.com/mdn/browser-compat-da
220
215
221
216
## Behavioral subfeatures
222
217
223
-
> [!NOTE]
224
-
> This guideline was added in August 2025 and feedback is welcome.
225
-
> If you have questions or concerns about how to apply it, [file an issue](https://github.com/mdn/browser-compat-data/issues/new/choose).
226
-
227
218
A behavioral subfeature records support for some facet, nuance, or evolution of a parent feature, where the behavior doesn't have a natural identifier (like CSS properties, API methods, or HTTP headers do).
228
219
Due to the lack of a natural identifier, a behavioral subfeature must have a `description`.
229
220
@@ -235,7 +226,7 @@ If a more specific guideline applies, follow that guideline instead of this one.
235
226
236
227
Behavioral subfeatures are rare.
237
228
Do not create a subfeature when the behavioral subfeature's `support` data would be the same, across all browsers, as the parent feature.
238
-
For serious bugs affecting a single engine, consider using `partial_implementation` instead. <!-- TODO: link to partial_implementation guidelines, when available -->
229
+
For serious bugs affecting a single engine, consider [using `partial_implementation`](#partial_implementation-general-usage-guidelines) instead.
239
230
240
231
You may create a behavioral subfeature for the following types of browser behaviors:
0 commit comments