Skip to content

chore: Move CSS sidebar into front matter #40356

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.

Sign up for GitHub

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

Jump to bottom
Merged
merged 1 commit into from
Jul 14, 2025
Merged

chore: Move CSS sidebar into front matter #40356

merged 1 commit into from
Jul 14, 2025

Conversation

dipikabh
Copy link
Contributor

Description

This PR:

  • Adds sidebar: cssref to the front matter
  • Removes the {{CSSRef}} macro

Motivation

With the support for sidebars in front matter, the sidebar macro can be removed now

Related issues and pull requests

@dipikabh dipikabh requested a review from bsmth July 14, 2025 12:48
@dipikabh dipikabh requested a review from a team as a code owner July 14, 2025 12:48
@github-actions github-actions bot added Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed labels Jul 14, 2025
@github-actions GitHub Actions
Copy link
Contributor

Preview URLs (300 pages)
Flaws (143)

Note! 239 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/CSS/-webkit-border-before
Title: -webkit-border-before
Flaw count: 7

  • macros:
    • Can't resolve /en-US/docs/Web/CSS/-webkit-border-before-color
    • Can't resolve /en-US/docs/Web/CSS/-webkit-border-before-style
    • Can't resolve /en-US/docs/Web/CSS/-webkit-border-before-width
    • Can't resolve /en-US/docs/Web/CSS/-webkit-border-after
    • Can't resolve /en-US/docs/Web/CSS/-webkit-border-start
    • and 2 more flaws omitted

URL: /en-US/docs/Web/CSS/-webkit-box-reflect
Title: -webkit-box-reflect
Flaw count: 3

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier

URL: /en-US/docs/Web/CSS/-webkit-mask-box-image
Title: -webkit-mask-box-image
Flaw count: 2

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/mask-image-source
    • Can't resolve /en-US/docs/Web/CSS/mask-image-offset

URL: /en-US/docs/Web/CSS/-webkit-mask-composite
Title: -webkit-mask-composite
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/composite-style

URL: /en-US/docs/Web/CSS/::-moz-color-swatch
Title: ::-moz-color-swatch
Flaw count: 1

  • macros:
    • Can't resolve /en-US/docs/Web/CSS/::-webkit-color-swatch

URL: /en-US/docs/Web/CSS/::-webkit-inner-spin-button
Title: ::-webkit-inner-spin-button
Flaw count: 1

  • macros:
    • Can't resolve /en-US/docs/Web/CSS/::-webkit-textfield-decoration-container

URL: /en-US/docs/Web/CSS/::view-transition-group
Title: ::view-transition-group()
Flaw count: 1

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/specificity which is a redirect

URL: /en-US/docs/Web/CSS/@color-profile
Title: @color-profile
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/declaration-list

URL: /en-US/docs/Web/CSS/@container
Title: @container
Flaw count: 12

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/block-contents
    • Can't resolve /en-US/docs/Web/CSS/size-feature
    • Can't resolve /en-US/docs/Web/CSS/scroll-state-feature
    • Can't resolve /en-US/docs/Web/CSS/function-token
    • Can't resolve /en-US/docs/Web/CSS/any-value
    • and 7 more flaws omitted

URL: /en-US/docs/Web/CSS/@counter-style
Title: @counter-style
Flaw count: 2

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/counter-style-name
    • Can't resolve /en-US/docs/Web/CSS/declaration-list

URL: /en-US/docs/Web/CSS/@counter-style/additive-symbols
Title: additive-symbols
Flaw count: 4

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier

URL: /en-US/docs/Web/CSS/@counter-style/fallback
Title: fallback
Flaw count: 2

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/counter-style-name

URL: /en-US/docs/Web/CSS/@counter-style/negative
Title: negative
Flaw count: 4

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier

URL: /en-US/docs/Web/CSS/@counter-style/pad
Title: pad
Flaw count: 4

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier

URL: /en-US/docs/Web/CSS/@counter-style/prefix
Title: prefix
Flaw count: 4

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier

URL: /en-US/docs/Web/CSS/@counter-style/range
Title: range
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@counter-style/speak-as
Title: speak-as
Flaw count: 2

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/counter-style-name

URL: /en-US/docs/Web/CSS/@counter-style/suffix
Title: suffix
Flaw count: 4

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier

URL: /en-US/docs/Web/CSS/@counter-style/symbols
Title: symbols
Flaw count: 4

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier

URL: /en-US/docs/Web/CSS/@counter-style/system
Title: system
Flaw count: 2

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/counter-style-name

URL: /en-US/docs/Web/CSS/@font-face
Title: @font-face
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/declaration-list

URL: /en-US/docs/Web/CSS/@font-face/ascent-override
Title: ascent-override
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@font-face/descent-override
Title: descent-override
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@font-face/font-display
Title: font-display
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@font-face/font-family
Title: font-family
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@font-face/font-feature-settings
Title: font-feature-settings
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@font-face/font-stretch
Title: font-stretch
Flaw count: 2

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/font-width

URL: /en-US/docs/Web/CSS/@font-face/font-style
Title: font-style
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@font-face/font-variation-settings
Title: font-variation-settings
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@font-face/font-weight
Title: font-weight
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@font-face/line-gap-override
Title: line-gap-override
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@font-face/size-adjust
Title: size-adjust
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@font-face/src
Title: src
Flaw count: 5

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/font-src-list
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier

URL: /en-US/docs/Web/CSS/@font-face/unicode-range
Title: unicode-range
Flaw count: 2

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/unicode-range-token

URL: /en-US/docs/Web/CSS/@font-feature-values
Title: @font-feature-values
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/declaration-rule-list

URL: /en-US/docs/Web/CSS/@font-palette-values
Title: @font-palette-values
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/declaration-list

URL: /en-US/docs/Web/CSS/@font-palette-values/base-palette
Title: base-palette
Flaw count: 3

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@font-palette-values/ which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/font-palette/ which is a redirect

URL: /en-US/docs/Web/CSS/@font-palette-values/font-family
Title: font-family
Flaw count: 3

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@font-palette-values/ which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/font-palette/ which is a redirect

URL: /en-US/docs/Web/CSS/@font-palette-values/override-colors
Title: override-colors
Flaw count: 3

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@font-palette-values/ which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/font-palette/ which is a redirect

URL: /en-US/docs/Web/CSS/@import
Title: @import
Flaw count: 9

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/declaration
    • Can't resolve /en-US/docs/Web/CSS/media-query-list
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • and 4 more flaws omitted

URL: /en-US/docs/Web/CSS/@keyframes
Title: @keyframes
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/qualified-rule-list

URL: /en-US/docs/Web/CSS/@layer
Title: @layer
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/rule-list

URL: /en-US/docs/Web/CSS/@media
Title: @media
Flaw count: 2

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/media-query-list
    • Can't resolve /en-US/docs/Web/CSS/rule-list

URL: /en-US/docs/Web/CSS/@namespace
Title: @namespace
Flaw count: 3

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier

URL: /en-US/docs/Web/CSS/@page
Title: @page
Flaw count: 2

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/declaration-rule-list
    • Can't resolve /en-US/docs/Web/CSS/ident-token

URL: /en-US/docs/Web/CSS/@page/page-orientation
Title: page-orientation
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@page/size
Title: size
Flaw count: 2

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/page-size

URL: /en-US/docs/Web/CSS/@position-try
Title: @position-try
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/declaration-list

URL: /en-US/docs/Web/CSS/@property
Title: @property
Flaw count: 2

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/custom-property-name
    • Can't resolve /en-US/docs/Web/CSS/declaration-list

URL: /en-US/docs/Web/CSS/@property/inherits
Title: inherits
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@property/initial-value
Title: initial-value
Flaw count: 2

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/declaration-value

URL: /en-US/docs/Web/CSS/@property/syntax
Title: syntax
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect

URL: /en-US/docs/Web/CSS/@scope
Title: @scope
Flaw count: 3

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/scope-start
    • Can't resolve /en-US/docs/Web/CSS/scope-end
    • Can't resolve /en-US/docs/Web/CSS/block-contents

URL: /en-US/docs/Web/CSS/@starting-style
Title: @starting-style
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/rule-list

URL: /en-US/docs/Web/CSS/@supports
Title: @supports
Flaw count: 5

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/rule-list
    • Can't resolve /en-US/docs/Web/CSS/function-token
    • Can't resolve /en-US/docs/Web/CSS/any-value
    • Can't resolve /en-US/docs/Web/CSS/any-value
    • Can't resolve /en-US/docs/Web/CSS/declaration

URL: /en-US/docs/Web/CSS/@view-transition
Title: @view-transition
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/declaration-list

URL: /en-US/docs/Web/CSS/animation-range
Title: animation-range
Flaw count: 2

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/timeline-range-name
    • Can't resolve /en-US/docs/Web/CSS/timeline-range-name

URL: /en-US/docs/Web/CSS/animation-range-end
Title: animation-range-end
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/timeline-range-name

URL: /en-US/docs/Web/CSS/animation-range-start
Title: animation-range-start
Flaw count: 1

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/timeline-range-name

URL: /en-US/docs/Web/CSS/attr
Title: attr()
Flaw count: 4

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/declaration-value
    • Can't resolve /en-US/docs/Web/CSS/ident-token
    • Can't resolve /en-US/docs/Web/CSS/ident-token
    • Can't resolve /en-US/docs/Web/CSS/attr-unit

URL: /en-US/docs/Web/CSS/backdrop-filter
Title: backdrop-filter
Flaw count: 4

  • broken_links:
    • Can't resolve /en-US/docs/Web/CSS/zero
    • Can't resolve /en-US/docs/Web/CSS/url-modifier
    • Can't resolve /en-US/docs/Web/CSS/url-token
    • Can't resolve /en-US/docs/Web/CSS/url-modifier

bsmth
bsmth approved these changes Jul 14, 2025
View reviewed changes
Copy link
Member

@bsmth bsmth left a comment

Choose a reason for hiding this comment

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

Great, thanks a lot!

@dipikabh
Copy link
Contributor Author

Thanks for the quick review!

@dipikabh dipikabh merged commit 0cc9980 into mdn:main Jul 14, 2025
7 checks passed
This was referenced Jul 15, 2025
Merged
Merged
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@bsmth bsmth bsmth approved these changes

Assignees
No one assigned
Labels
Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
2 participants
@dipikabh @bsmth