Skip to content

docs(docs-infra): improve docs for styling precedence and class binding.#49435

Closed
avmaxim wants to merge 1 commit into
angular:mainfrom
avmaxim:feature/docs-styling-precedence
Closed

docs(docs-infra): improve docs for styling precedence and class binding.#49435
avmaxim wants to merge 1 commit into
angular:mainfrom
avmaxim:feature/docs-styling-precedence

Conversation

@avmaxim
Copy link
Copy Markdown
Contributor

@avmaxim avmaxim commented Mar 15, 2023

This PR removes the confusing section - ## Style Precendece - from Class and style binding docs and adds more clarification to it in the following sections: ## Binding to multiple styles and ## Binding to multiple CSS classes which already contain references to Style Precedence docs. Hence, there is no need to duplicate it as a separate section.

Fixes #48522.

PR Checklist

Please check if your PR fulfills the following requirements:

PR Type

What kind of change does this PR introduce?

  • Bugfix
  • Feature
  • Code style update (formatting, local variables)
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • CI related changes
  • Documentation content changes
  • angular.io application / infrastructure changes

Does this PR introduce a breaking change?

  • Yes
  • No

This PR removes confusing "Styling Precedence" section from the "Class Binding" docs and adds more clarification on it in the following sections: "Binding to multiple styles" and "Binding to multiple CSS classes" which already have references to the "Style Precedence" docs, so there is no need to duplicate it.

Fixes angular#48522.
@ngbot ngbot Bot added this to the Backlog milestone Mar 15, 2023
@avmaxim avmaxim mentioned this pull request Mar 15, 2023
@avmaxim
Copy link
Copy Markdown
Contributor Author

avmaxim commented Mar 15, 2023

@alan-agius4 @bob-watson Please take a look based on this discussion - #48522 (comment)

@jessicajaniuk jessicajaniuk added action: review The PR is still awaiting reviews from at least one requested reviewer target: patch This PR is targeted for the next patch release labels Apr 18, 2023
@jessicajaniuk
Copy link
Copy Markdown
Contributor

@avmaxim Can you rebase to latest? That would likely resolve the CI issues.

@pkozlowski-opensource
Copy link
Copy Markdown
Member

Thnx for the PR @avmaxim - looking at it I don't think that "These rules specify an order for which style-related bindings have priority" sentence adds much clarification as "precedence" implies "priority", IMO.

I'm going to close this PR based on the above but we can sure iterate on a different version of the wording.

@angular-automatic-lock-bot
Copy link
Copy Markdown

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

This action has been performed automatically by a bot.

@angular-automatic-lock-bot angular-automatic-lock-bot Bot locked and limited conversation to collaborators Jul 8, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

action: review The PR is still awaiting reviews from at least one requested reviewer target: patch This PR is targeted for the next patch release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Styling precedence

3 participants