Skip to content

CSS guides: change css links to macros #41922

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 6 commits into from
Nov 17, 2025
Merged

CSS guides: change css links to macros #41922

merged 6 commits into from
Nov 17, 2025

Conversation

@estelle
Copy link
Member

@estelle estelle commented Nov 13, 2025

No description provided.

@estelle estelle requested a review from a team as a code owner November 13, 2025 05:59
@estelle estelle requested review from chrisdavidmills and removed request for a team November 13, 2025 05:59
@github-actions github-actions bot added the Content:CSS Cascading Style Sheets docs label Nov 13, 2025
@estelle estelle changed the title CSS guides: change css links to macros DRAFT: CSS guides: change css links to macros Nov 13, 2025
@estelle estelle marked this pull request as draft November 13, 2025 06:00
@github-actions github-actions bot added the size/m [PR only] 51-500 LoC changed label Nov 13, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Nov 13, 2025 •
edited
Loading

Preview URLs (51 pages)
Flaws (1339)

Note! 1 document with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/CSS/Guides/Anchor_positioning
Title: CSS anchor positioning
Flaw count: 49

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/anchor-name which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position-anchor which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position-area which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position-try-fallbacks which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position-try-order which is a redirect
    • and 44 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Anchor_positioning/Try_options_hiding
Title: Fallback options and conditional hiding for overflow
Flaw count: 17

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/position-try-fallbacks which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@position-try which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position-try-order which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position-try which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position-visibility which is a redirect
    • and 12 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Anchor_positioning/Using
Title: Using CSS anchor positioning
Flaw count: 57

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/anchor-name which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/dashed-ident which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/width which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position-anchor which is a redirect
    • and 51 more flaws omitted
  • unknown:
    • Error parsing /shared-assets/images/diagrams/css/anchor-positioning/position-area.svg: No such file or directory (os error 2)

URL: /en-US/docs/Web/CSS/Guides/Animations
Title: CSS animations
Flaw count: 20

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/animation-iteration-count which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/animation-direction which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/animation-fill-mode which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/animation-play-state which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/animation which is a redirect
    • and 15 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Animations/Using
Title: Using CSS animations
Flaw count: 35

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/animation which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@keyframes which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/animation which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/animation-composition which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/animation-delay which is a redirect
    • and 30 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Basic_user_interface
Title: CSS basic user interface
Flaw count: 27

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/outline which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/outline-offset which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/accent-color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/caret-color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/cursor which is a redirect
    • and 22 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Borders_and_box_decorations
Title: CSS borders and box decorations
Flaw count: 99

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/corner-shape which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/border-radius which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/box-shadow which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/border-block which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/border-block-color which is a redirect
    • and 94 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Box_alignment/In_block_abspos_tables
Title: Box alignment for block, absolutely positioned, and table layouts
Flaw count: 6

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/justify-content which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/align-content which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/justify-self which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/align-self which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/margin which is a redirect
    • and 1 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Box_model
Title: CSS box model
Flaw count: 68

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/margin which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/margin-bottom which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/margin-left which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/margin-right which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/margin-top which is a redirect
    • and 63 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Cascade
Title: CSS cascading and inheritance
Flaw count: 10

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/all which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@import which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@layer which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/initial which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/inherit which is a redirect
    • and 5 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Cascade/Inheritance
Title: Inheritance
Flaw count: 14

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/border which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/border-style which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/inherit which is a redirect
    • and 9 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Cascade/Introduction
Title: Introduction to the CSS cascade
Flaw count: 17

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@scope which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@layer which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@layer which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@keyframes which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/transition which is a redirect
    • and 12 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Cascade/Property_value_processing
Title: CSS property value processing
Flaw count: 54

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/specificity which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@media which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@supports which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/font-size which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/font-weight which is a redirect
    • and 49 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Cascade/Specificity
Title: Specificity
Flaw count: 17

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/Universal_selectors which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/:where which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/Next-sibling_combinator which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/Child_combinator which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/Subsequent-sibling_combinator which is a redirect
    • and 12 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Cascading_variables
Title: CSS custom properties for cascading variables
Flaw count: 8

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/background-color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/color_value/hsl which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/color_value which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/hue which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/calc which is a redirect
    • and 3 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Cascading_variables/Using_custom_properties
Title: Using CSS custom properties (variables)
Flaw count: 17

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@property which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/var which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@property which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/var which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/var which is a redirect
    • and 12 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Colors
Title: CSS colors
Flaw count: 36

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/opacity which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/background-color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/accent-color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/color which is a redirect
    • and 31 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Colors/Applying_color
Title: Applying color to HTML elements using CSS
Flaw count: 47

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/background-color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/background-color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/text-shadow which is a redirect
    • and 42 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Colors/Color_values
Title: CSS color values
Flaw count: 21

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/color_value which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/system-color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/named-color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/hex-color which is a redirect
    • and 16 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Colors/Using_relative_colors
Title: Using relative colors
Flaw count: 18

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/color_value which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/color_value which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/alpha-value which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/calc which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/number which is a redirect
    • and 13 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Conditional_rules/Using_feature_queries
Title: Using feature queries
Flaw count: 5

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@supports which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@import which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@media which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/system-color which is a redirect

URL: /en-US/docs/Web/CSS/Guides/Containment/Container_size_and_style_queries
Title: Using container size and style queries
Flaw count: 29

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@media which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@container which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@container which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/container-type which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/container which is a redirect
    • and 24 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Display/Block_formatting_context
Title: Block formatting context
Flaw count: 15

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/float which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/display which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/display which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/display which is a redirect
    • and 10 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Display/Flow_layout_and_overflow
Title: Flow layout and overflow
Flaw count: 4

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/overflow which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/overflow-x which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/overflow-y which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/text-overflow which is a redirect

URL: /en-US/docs/Web/CSS/Guides/Display/Multi-keyword_syntax
Title: Using the multi-keyword syntax with CSS display
Flaw count: 2

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

URL: /en-US/docs/Web/CSS/Guides/Filter_effects
Title: CSS filter effects
Flaw count: 17

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/backdrop-filter which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/filter which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/filter-function/blur which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/filter-function/brightness which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/filter-function/contrast which is a redirect
    • and 12 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Filter_effects/Using
Title: Using filter effects
Flaw count: 37

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/filter which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/backdrop-filter which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/filter-function which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/filter which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/backdrop-filter which is a redirect
    • and 32 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Flexible_box_layout/Basic_concepts
Title: Basic concepts of flexbox
Flaw count: 25

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/flex-direction which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/display which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/flex-direction which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/flex-grow which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/flex-shrink which is a redirect
    • and 20 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Flexible_box_layout/Use_cases
Title: Typical use cases of flexbox
Flaw count: 8

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/justify-content which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/flex which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/gap which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/flex-direction which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/max-width which is a redirect
    • and 3 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Fonts/Variable_fonts
Title: Variable fonts
Flaw count: 15

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@font-face which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/font-family which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/font-style which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/font-variation-settings which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/font-feature-settings which is a redirect
    • and 10 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Images/Using_object-view-box
Title: Using the CSS object-view-box property
Flaw count: 8

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/object-view-box which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/object-fit which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/object-fit which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/basic-shape/xywh which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/object-view-box which is a redirect
    • and 3 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Logical_properties_and_values
Title: CSS logical properties and values
Flaw count: 82

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/block-size which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/border-block which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/border-block-color which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/border-block-end which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/border-block-end-color which is a redirect
    • and 77 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Media_queries
Title: CSS media queries
Flaw count: 48

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@media which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@import which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@import which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@media which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@media/any-hover which is a redirect
    • and 43 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Motion_path
Title: CSS motion path
Flaw count: 36

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/transform which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/offset-path which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/offset-distance which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/offset-rotate which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/basic-shape/path which is a redirect
    • and 31 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Namespaces
Title: CSS namespaces
Flaw count: 2

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

URL: /en-US/docs/Web/CSS/Guides/Nesting/At-rules
Title: CSS nesting at-rules
Flaw count: 7

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@media which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@supports which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@layer which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@scope which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@container which is a redirect
    • and 2 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Overflow
Title: CSS overflow
Flaw count: 32

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/line-clamp which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/overflow which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/overflow-block which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/overflow-clip-margin which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/overflow-inline which is a redirect
    • and 27 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Overflow/Carousels
Title: Creating CSS carousels
Flaw count: 47

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/::scroll-button which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/::scroll-marker-group which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/::scroll-marker which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/::scroll-marker-group which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/:target-current which is a redirect
    • and 41 more flaws omitted
  • unknown:
    • Error parsing /shared-assets/images/diagrams/css/carousels/carousel.svg: No such file or directory (os error 2)

URL: /en-US/docs/Web/CSS/Guides/Positioned_layout/Stacking_context
Title: Stacking context
Flaw count: 27

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/position which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/z-index which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/position which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/container-type which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/z-index which is a redirect
    • and 22 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Properties_and_values_API
Title: CSS properties and values API
Flaw count: 3

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

URL: /en-US/docs/Web/CSS/Guides/Scroll_snap/Basic_concepts
Title: Basic concepts of scroll snap
Flaw count: 13

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/overflow which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/scroll-snap-type which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/scroll-snap-align which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/scroll-snap-stop which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/scroll-margin which is a redirect
    • and 8 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Shadow_parts
Title: CSS shadow parts
Flaw count: 6

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/::part which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/::part which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/:host which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/:host_function which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/:host-context which is a redirect
    • and 1 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Shapes/Using_shape-outside
Title: Basic shapes with shape-outside
Flaw count: 11

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/basic-shape which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/shape-outside which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/basic-shape which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/box-edge which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/border-radius which is a redirect
    • and 6 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Syntax
Title: CSS syntax
Flaw count: 7

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@charset which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/at-rule which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/@import which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/important which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/var which is a redirect
    • and 2 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Text/Whitespace
Title: Handling whitespace
Flaw count: 9

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/white-space which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/white-space-collapse which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/white-space which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/white-space-collapse which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/white-space-collapse which is a redirect
    • and 4 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Transforms
Title: CSS transforms
Flaw count: 55

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/perspective which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/perspective-origin which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/backface-visibility which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/perspective which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/perspective-origin which is a redirect
    • and 50 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Transitions
Title: CSS transitions
Flaw count: 36

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/@starting-style which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/display which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/transition which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/transition-behavior which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/transition-delay which is a redirect
    • and 31 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Transitions/Using
Title: Using CSS transitions
Flaw count: 14

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/transition which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/transition-property which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/transition-duration which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/transition-timing-function which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/transition-delay which is a redirect
    • and 9 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Values_and_units
Title: CSS values and units
Flaw count: 64

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/interpolate-size which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/abs which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/acos which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/asin which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/atan which is a redirect
    • and 59 more flaws omitted

URL: /en-US/docs/Web/CSS/Guides/Values_and_units/Value_definition_syntax
Title: Value definition syntax
Flaw count: 38

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_values_and_units/Value_definition_syntax#brackets is a redirect
    • /en-US/docs/Web/CSS/CSS_values_and_units/Value_definition_syntax#double_ampersand is a redirect
    • /en-US/docs/Web/CSS/length is a redirect
    • /en-US/docs/Web/CSS/CSS_values_and_units/Value_definition_syntax#brackets is a redirect
    • /en-US/docs/Web/CSS/length is a redirect
    • and 29 more flaws omitted
  • macros:
    • Macro produces link /en-US/docs/Web/CSS/angle which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/string which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/length which is a redirect
    • Macro produces link /en-US/docs/Web/CSS/column-count which is a redirect

(comment last updated: 2025-11-16 19:03:18)

@chrisdavidmills chrisdavidmills removed their request for review November 13, 2025 07:51
@chrisdavidmills
Copy link
Contributor

chrisdavidmills commented Nov 13, 2025

Removing my review; feel free to add me back when this is out of draft/ready for review.

@estelle estelle changed the title DRAFT: CSS guides: change css links to macros CSS guides: change css links to macros Nov 16, 2025
@estelle estelle marked this pull request as ready for review November 16, 2025 19:04
@hamishwillee
Copy link
Collaborator

hamishwillee commented Nov 16, 2025

@estelle Previous discussions of using macro vs links have resulted in "it literally does not matter which you use, even for consistency". Just FMI, is there no some sort of guideline that changes that? ( I don't "care", other than I might have missed a way of working rule).

@estelle
Copy link
Member Author

estelle commented Nov 17, 2025

@estelle Previous discussions of using macro vs links have resulted in "it literally does not matter which you use, even for consistency". Just FMI, is there no some sort of guideline that changes that? ( I don't "care", other than I might have missed a way of working rule).

Cognitively macros are much easier, esp in the CSS section, so limiting my edits to this section (and a few glossary pages)

chrisdavidmills
chrisdavidmills approved these changes Nov 17, 2025
View reviewed changes
Copy link
Contributor

@chrisdavidmills chrisdavidmills left a comment

Choose a reason for hiding this comment

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

LGTM

@chrisdavidmills chrisdavidmills merged commit 91ff328 into main Nov 17, 2025
13 checks passed
@chrisdavidmills chrisdavidmills deleted the macro-guides branch November 17, 2025 07:42
@Josh-Cena Josh-Cena mentioned this pull request Nov 17, 2025
Merged
@bsmth bsmth mentioned this pull request Nov 18, 2025
Open
chrisdavidmills added a commit that referenced this pull request Nov 18, 2025
@chrisdavidmills
Revert "CSS guides: change css links to macros (#41922)"
22c6f0f 
This reverts commit 91ff328.
@chrisdavidmills chrisdavidmills mentioned this pull request Nov 18, 2025
Merged
chrisdavidmills added a commit that referenced this pull request Nov 18, 2025
@chrisdavidmills
Revert "CSS guides: change css links to macros" (#41989)
81f8fcd 
Revert "CSS guides: change css links to macros (#41922)"

This reverts commit 91ff328.
@estelle estelle restored the macro-guides branch November 18, 2025 10:37
estelle added a commit that referenced this pull request Nov 18, 2025
@estelle
CSS guides: change css links to macros (#41922)
1f8d860 
* CSS guides: change css links to macros

* svg macros

* error checking

* example height

* example height
estelle pushed a commit that referenced this pull request Nov 18, 2025
@chrisdavidmills @estelle
Revert "CSS guides: change css links to macros" (#41989)
dcec3f1 
Revert "CSS guides: change css links to macros (#41922)"

This reverts commit 91ff328.
estelle pushed a commit that referenced this pull request Nov 18, 2025
@chrisdavidmills @estelle
Revert "CSS guides: change css links to macros" (#41989)
c4e8d53 
Revert "CSS guides: change css links to macros (#41922)"

This reverts commit 91ff328.
estelle added a commit that referenced this pull request Nov 18, 2025
@estelle
CSS guides: change css links to macros (#41922)
66046ca 
* CSS guides: change css links to macros

* svg macros

* error checking

* example height

* example height
estelle pushed a commit that referenced this pull request Nov 18, 2025
@chrisdavidmills @estelle
Revert "CSS guides: change css links to macros" (#41989)
85da16d 
Revert "CSS guides: change css links to macros (#41922)"

This reverts commit 91ff328.
estelle added a commit that referenced this pull request Nov 18, 2025
@estelle
CSS guides: change css links to macros (#41922)
33b603a 
* CSS guides: change css links to macros

* svg macros

* error checking

* example height

* example height
estelle pushed a commit that referenced this pull request Nov 18, 2025
@chrisdavidmills @estelle
Revert "CSS guides: change css links to macros" (#41989)
cdabca4 
Revert "CSS guides: change css links to macros (#41922)"

This reverts commit 91ff328.
estelle added a commit that referenced this pull request Nov 18, 2025
@estelle
CSS guides: change css links to macros (#41922)
6a69fba 
* CSS guides: change css links to macros

* svg macros

* error checking

* example height

* example height
estelle added a commit that referenced this pull request Nov 18, 2025
@estelle
CSS guides: change css links to macros (#41922)
f82a776 
* CSS guides: change css links to macros

* svg macros

* error checking

* example height

* example height
estelle pushed a commit that referenced this pull request Nov 18, 2025
@chrisdavidmills @estelle
Revert "CSS guides: change css links to macros" (#41989)
13624f1 
Revert "CSS guides: change css links to macros (#41922)"

This reverts commit 91ff328.
estelle added a commit that referenced this pull request Nov 18, 2025
@estelle
CSS guides: change css links to macros (#41922)
306053f 
* CSS guides: change css links to macros

* svg macros

* error checking

* example height

* example height
estelle pushed a commit that referenced this pull request Nov 18, 2025
@chrisdavidmills @estelle
Revert "CSS guides: change css links to macros" (#41989)
0091611 
Revert "CSS guides: change css links to macros (#41922)"

This reverts commit 91ff328.
estelle pushed a commit that referenced this pull request Nov 18, 2025
@chrisdavidmills @estelle
Revert "CSS guides: change css links to macros" (#41989)
be0a27c 
Revert "CSS guides: change css links to macros (#41922)"

This reverts commit 91ff328.
estelle pushed a commit that referenced this pull request Nov 18, 2025
@chrisdavidmills @estelle
Revert "CSS guides: change css links to macros" (#41989)
9c74e71 
Revert "CSS guides: change css links to macros (#41922)"

This reverts commit 91ff328.
estelle pushed a commit that referenced this pull request Nov 18, 2025
@chrisdavidmills @estelle
Revert "CSS guides: change css links to macros" (#41989)
e6811b8 
Revert "CSS guides: change css links to macros (#41922)"

This reverts commit 91ff328.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@chrisdavidmills chrisdavidmills chrisdavidmills 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.

3 participants

@estelle @chrisdavidmills @hamishwillee