Skip to content

Embellish partial_implementation guideline#29661

Open
ddbeck wants to merge 5 commits into
mdn:mainfrom
ddbeck:push-mmxltrxlsxpv
Open

Embellish partial_implementation guideline#29661
ddbeck wants to merge 5 commits into
mdn:mainfrom
ddbeck:push-mmxltrxlsxpv

Conversation

@ddbeck
Copy link
Copy Markdown
Contributor

@ddbeck ddbeck commented May 12, 2026

Summary

This adds some more detail to our partial implementation guideline, covering second opinions and negative impact on developers.

Test results and supporting details

Based on a discussion on the BCD call today, about how to improve our process on setting and reviewing the partial_implementation flag.

Related issues

@github-actions github-actions Bot added docs Issues or pull requests regarding the documentation of this project. size:s [PR only] 7-24 LoC changed labels May 12, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 12, 2026

Tip: Review these changes grouped by change (recommended for most PRs), or grouped by feature (for large PRs).

Copy link
Copy Markdown
Member

@Elchi3 Elchi3 left a comment

Choose a reason for hiding this comment

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

Thanks Daniel, this is very helpful.

Comment thread docs/data-guidelines/README.md Outdated
@ddbeck ddbeck requested a review from caugner May 12, 2026 16:37
Copy link
Copy Markdown
Contributor

@caugner caugner left a comment

Choose a reason for hiding this comment

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

LGTM, except for the bit about "Many bug report[s] filed by web developers".

Comment thread docs/data-guidelines/README.md Outdated
Strong signals of negative impact include:

- Bug reports filed by web developers shortly after a new implementation has shipped
- Many bug report filed by web developers or many comments from web developers on existing bug reports
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Found a typo: 🥇

Suggested change
- Many bug report filed by web developers or many comments from web developers on existing bug reports
- Many bug reports filed by web developers or many comments from web developers on existing bug reports

But most importantly, I'm not sure about:

  • "Many" -> this suggests a single bug report isn't sufficient?
  • "filed by web developers" -> this suggests bugs filed by the engine developers themselves don't count?

How about re-framing this as:

Suggested change
- Many bug report filed by web developers or many comments from web developers on existing bug reports
- Bug reports filed later with significant attention from web developers (through upvotes, comments, blog posts, or social media posts)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

(Maybe "demonstrable attention"?)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

What I'm trying to get at here is that multiple developers have confirmed that the bug impacts them. They can do that by:

  • Filing multiple independent or closely related bugs
  • Commenting or upvoting on one existing bug
  • Complaining in some other linkable venue (e.g., social media)

And yes, engine developers filing bugs is not a (strong) signal of impact on developers, absent other information (e.g., "I, engine developer, filed this bug because of a complaint I saw on social media").

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

My main point is that I would expect there rarely to be "many" reports for any bug, there's usually one and maybe a few duplicates, but not many. Maybe the focus could be on evidence that this affects many web developers.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

OK, I've revised the text to avoid the word "many." See 3da308f.

ddbeck and others added 3 commits May 13, 2026 18:07
@caugner
Copy link
Copy Markdown
Contributor

caugner commented May 15, 2026

@ddbeck I'll let you merge in case you want to revise more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Issues or pull requests regarding the documentation of this project. size:s [PR only] 7-24 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants