Skip to content

Commit 42705c1

Browse files
authored
Drop new notices on partial and behavioral guidelines (#29703)
1 parent 7a4dbae commit 42705c1

1 file changed

Lines changed: 2 additions & 11 deletions

File tree

docs/data-guidelines/README.md

Lines changed: 2 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -58,10 +58,6 @@ This guideline was adopted to protect the quality of stable data in the face of
5858

5959
## `"partial_implementation"` general usage guidelines
6060

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-
6561
The partial implementation flag often requires a judgment call.
6662
If you're not completely certain, ask for a second opinion.
6763

@@ -95,8 +91,7 @@ Here are some example situations where this guideline may or may not apply:
9591

9692
- `"partial_implementation": false`: All implementing browsers provide a form control user interface, but the specification gives the implementer discretion over its look and feel.
9793
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.
10095

10196
- `"partial_implementation": false`: An implementing browser fails a web platform test against a corner case.
10297
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
220215

221216
## Behavioral subfeatures
222217

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-
227218
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).
228219
Due to the lack of a natural identifier, a behavioral subfeature must have a `description`.
229220

@@ -235,7 +226,7 @@ If a more specific guideline applies, follow that guideline instead of this one.
235226

236227
Behavioral subfeatures are rare.
237228
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.
239230

240231
You may create a behavioral subfeature for the following types of browser behaviors:
241232

0 commit comments

Comments
 (0)