Skip to content

Conversation

@Josh-Cena
Copy link
Member

After #40228, we are a lot more explicit on some CSS stylistic decisions. In particular, we now require all non-generic font family names to be quoted, no exceptions—not even "Arial". In addition, I noticed that the weird Arial, Helvetica, sans-serif combination is used a lot—which is pointless because every computer that supports Helvetica is also going to support Arial, so I reordered these two.

@Josh-Cena Josh-Cena requested a review from a team as a code owner October 11, 2025 03:45
@Josh-Cena Josh-Cena requested review from bsmth and estelle and removed request for a team and estelle October 11, 2025 03:45
@github-actions github-actions bot added Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed labels Oct 11, 2025
@github-actions
Copy link
Contributor

Preview URLs (48 pages)
Flaws (359)

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

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

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

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

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

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

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

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

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#hash_mark is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • and 3 more flaws omitted

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

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • and 5 more flaws omitted

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

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#curly_braces is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

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

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

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: 36

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/font-src-list
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#question_mark is ill cased
    • and 31 more flaws omitted

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

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • Can't resolve /en-US/docs/Web/CSS/unicode-range-token
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#hash_mark is ill cased

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/font-family
Title: font-family
Flaw count: 6

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#hash_mark is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#plus is ill cased
  • 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/@page/page-orientation
Title: page-orientation
Flaw count: 3

  • broken_links:
    • /en-US/docs/Web/CSS/At-rule is a redirect
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

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/font-family
Title: font-family
Flaw count: 20

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#hash_mark is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • and 15 more flaws omitted

URL: /en-US/docs/Web/CSS/font-feature-settings
Title: font-feature-settings
Flaw count: 7

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#hash_mark is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • and 2 more flaws omitted

URL: /en-US/docs/Web/CSS/font-optical-sizing
Title: font-optical-sizing
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

URL: /en-US/docs/Web/CSS/font-palette
Title: font-palette
Flaw count: 41

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • Can't resolve /en-US/docs/Web/CSS/palette-identifier
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • and 36 more flaws omitted

URL: /en-US/docs/Web/CSS/font-palette/palette-mix
Title: palette-mix()
Flaw count: 37

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • and 32 more flaws omitted

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

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

URL: /en-US/docs/Web/CSS/font-stretch
Title: font-stretch
Flaw count: 9

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • and 4 more flaws omitted

URL: /en-US/docs/Web/CSS/font-style
Title: font-style
Flaw count: 5

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#question_mark is ill cased

URL: /en-US/docs/Web/CSS/font-synthesis
Title: font-synthesis
Flaw count: 6

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#double_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#double_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#double_bar is ill cased
    • and 1 more flaws omitted

URL: /en-US/docs/Web/CSS/font-variant-alternates
Title: font-variant-alternates
Flaw count: 11

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#double_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#double_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#hash_mark is ill cased
    • and 6 more flaws omitted

URL: /en-US/docs/Web/CSS/font-variant-east-asian
Title: font-variant-east-asian
Flaw count: 11

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#double_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#double_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • and 6 more flaws omitted

URL: /en-US/docs/Web/CSS/font-variant-ligatures
Title: font-variant-ligatures
Flaw count: 12

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#double_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#double_bar is ill cased
    • and 6 more flaws omitted
  • macros:
    • Can't resolve /en-US/docs/Glossary/contextual_forms

URL: /en-US/docs/Web/CSS/font-variation-settings
Title: font-variation-settings
Flaw count: 4

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#hash_mark is ill cased

URL: /en-US/docs/Web/CSS/if
Title: if()
Flaw count: 2

  • macros:
    • Macro produces link /en-US/docs/Web/CSS/linear-gradient which is a redirect
  • unknown:
    • Parse error: Unexpected input

URL: /en-US/docs/Web/CSS/interpolate-size
Title: interpolate-size
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

URL: /en-US/docs/Web/CSS/justify-items
Title: justify-items
Flaw count: 29

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#question_mark is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#brackets is ill cased
    • and 24 more flaws omitted

URL: /en-US/docs/Web/CSS/justify-self
Title: justify-self
Flaw count: 23

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#question_mark is ill cased
    • and 18 more flaws omitted

URL: /en-US/docs/Web/CSS/letter-spacing
Title: letter-spacing
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

URL: /en-US/docs/Web/CSS/line-break
Title: line-break
Flaw count: 4

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

URL: /en-US/docs/Web/CSS/line-height
Title: line-height
Flaw count: 3

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

URL: /en-US/docs/Web/CSS/object-fit
Title: object-fit
Flaw count: 4

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

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

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

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

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

URL: /en-US/docs/Web/CSS/place-self
Title: place-self
Flaw count: 31

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#question_mark is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • and 26 more flaws omitted

URL: /en-US/docs/Web/CSS/position
Title: position
Flaw count: 6

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_positioned_layout/Understanding_z-index/Stacking_context is a redirect
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • and 1 more flaws omitted

URL: /en-US/docs/Web/CSS/scroll-target-group
Title: scroll-target-group
Flaw count: 1

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased

URL: /en-US/docs/Web/CSS/superellipse
Title: superellipse()
Flaw count: 2

  • broken_links:
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased
    • /en-US/docs/Web/CSS/CSS_Values_and_Units/Value_definition_syntax#single_bar is ill cased


@font-palette-values --blue-nabla {
font-family: Nabla;
font-family: "Nabla";
Copy link
Collaborator

Choose a reason for hiding this comment

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

The CSS rules recommend a fallback, but don't cover the case where there is no natural fallback. I am therefore assuming things like this are fine.

Copy link
Collaborator

@hamishwillee hamishwillee left a comment

Choose a reason for hiding this comment

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

Thanks very much @Josh-Cena

@hamishwillee hamishwillee merged commit a3eec14 into mdn:main Oct 13, 2025
7 checks passed
@Josh-Cena Josh-Cena deleted the font-family-quotes-3 branch October 13, 2025 00:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants