Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

HTML page has non-empty title [2779a5]: Shadow root example - Included as failed example 6 #2180

Merged
merged 3 commits into from
Sep 30, 2024

Conversation

giacomo-petri
Copy link
Collaborator

Closes issue(s): #2179

Description:
Adding a failed example of an HTML page lacking a title but featuring a shadow root with a non-empty <title> that does not affect the page title into the HTML page has non-empty title [2779a5] rule.

Need for Call for Review:
This will require a 1 week Call for Review


Pull Request Etiquette

When creating PR:

  • Make sure you're requesting to pull a branch (right side) to the develop branch (left side).
  • Make sure you do not remove the "How to Review and Approve" section in your pull request description

After creating PR:

  • Add yourself (and co-authors) as "Assignees" for PR.
  • Add label to indicate if it's a Rule, Definition or Chore.
  • Link the PR to any issue it solves. This will be done automatically by referencing the issue at the top of this comment in the indicated place.
  • Optionally request feedback from anyone in particular by assigning them as "Reviewers".

When merging a PR:

  • Close any issue that the PR resolves. This will happen automatically upon merging if the PR was correctly linked to the issue, e.g. by referencing the issue at the top of this comment.

How to Review And Approve

  • Go to the “Files changed” tab
  • Here you will have the option to leave comments on different lines.
  • Once the review is completed, find the “Review changes” button in the top right, select “Approve” (if you are really confident in the rule) or "Request changes" and click “Submit review”.
  • Make sure to also review the proposed Call for Review period. In case of disagreement, the longer period wins.

@giacomo-petri giacomo-petri self-assigned this Apr 10, 2024
Copy link
Collaborator

@Jym77 Jym77 left a comment

Choose a reason for hiding this comment

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

I'm a bit wondering whether we should be clearer (maybe also in the Expectation) which tree is used for finding descendants (i.e., the shadow tree is a descendant in the flat tree of the root document, but it is not a descendant in the DOM tree, which the rule consider by default since no precision is made).

But that's a bit of a separate problem.

@giacomo-petri
Copy link
Collaborator Author

Hi @Jym77,

to be honest, it took me a while to figure out if Expectation 2 was supposed to clarify how to deal with shadow roots, but after reviewing the definitions, I think it's accurate. However, I do agree that it could be clearer and less time-consuming for users to understand how to handle shadow roots.

@Jym77
Copy link
Collaborator

Jym77 commented Apr 18, 2024

Hi @Jym77,

to be honest, it took me a while to figure out if Expectation 2 was supposed to clarify how to deal with shadow roots, but after reviewing the definitions, I think it's accurate. However, I do agree that it could be clearer and less time-consuming for users to understand how to handle shadow roots.

Yes, I think this is correct (this is also Alfa's interpretation). I think that this is a very old rule and we were not so conscious then about the differences between DOM and flat tree 😅 In any case, the example makes it clear that shadow DOM is ignored, so that's definitely going in the good direction.

Copy link
Member

@WilcoFiers WilcoFiers left a comment

Choose a reason for hiding this comment

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

Small suggestion

_rules/html-page-non-empty-title-2779a5.md Outdated Show resolved Hide resolved
@giacomo-petri giacomo-petri added Review Call 1 week Call for review for small changes and removed reviewers wanted labels Sep 3, 2024
@giacomo-petri
Copy link
Collaborator Author

1 week call for review ends on September 11th.

Copy link

@sage-putnam sage-putnam left a comment

Choose a reason for hiding this comment

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

Looks great to me!

@Jym77
Copy link
Collaborator

Jym77 commented Sep 30, 2024

Call for Review has ended, merging.

@Jym77 Jym77 merged commit d77d6fc into develop Sep 30, 2024
2 checks passed
@Jym77 Jym77 deleted the giacomo-petri-added-shadow-root-example-to-page-title branch September 30, 2024 14:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Review Call 1 week Call for review for small changes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants