Skip to content

Intro to css values - #44937

Merged
dipikabh merged 8 commits into
mdn:mainfrom
estelle:values5
Aug 11, 2026
Merged

Intro to css values#44937
dipikabh merged 8 commits into
mdn:mainfrom
estelle:values5

Conversation

@estelle

@estelle estelle commented Jul 27, 2026

Copy link
Copy Markdown
Member

CSS properties include a "Values" section.
Sometimes there is an intro to the values. sometimes there isn't.
This is the third PR in an attempt to make things consistent. This PR addresses some of the properties that had no intro sentence in the values section that and didn't need a whole bunch of other work done

continuation of #44833

@estelle
estelle requested a review from a team as a code owner July 27, 2026 20:25
@estelle
estelle requested review from dipikabh and removed request for a team July 27, 2026 20:25
@github-actions github-actions Bot added Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed labels Jul 27, 2026
@github-actions

github-actions Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor
Preview URLs (22 pages)
Flaws (7)

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

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/Web/CSS/Reference/Properties/hyphenate-limit-chars
Title: hyphenate-limit-chars CSS property
Flaw count: 1

  • macros:
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/number-token which doesn't resolve

URL: /en-US/docs/Web/CSS/Reference/Properties/initial-letter
Title: initial-letter CSS property
Flaw count: 1

  • macros:
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/number-token which doesn't resolve

URL: /en-US/docs/Web/CSS/Reference/Properties/line-clamp
Title: line-clamp CSS property
Flaw count: 2

  • macros:
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Properties/block-ellipsis which doesn't resolve
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/number-token which doesn't resolve

URL: /en-US/docs/Web/CSS/Reference/Properties/list-style-image
Title: list-style-image CSS property
Flaw count: 3

  • macros:
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/url which doesn't resolve
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/url which doesn't resolve
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/hash-token which doesn't resolve

(comment last updated: 2026-08-10 16:43:57)

estelle and others added 3 commits July 28, 2026 14:36
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
…s/index.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Comment thread files/en-us/web/css/reference/properties/font-variant-ligatures/index.md Outdated

@dipikabh dipikabh left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thanks, @estelle
I have similar suggestions as I've left in #44936. LMK what you think.

@@ -74,6 +74,8 @@ The `font-style` property is specified as a single keyword chosen from the list

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change

@@ -87,6 +87,8 @@ The `font-weight` property is specified using either a `<font-weight-absolute>`

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change

Comment thread files/en-us/web/css/reference/properties/font-variant-caps/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/line-height/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/line-clamp/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/hyphenate-limit-chars/index.md Outdated
Comment on lines 44 to 51
- `<number> <number> <number>`
- : The first value is the minimum word length before words should be hyphenated. The second value is the minimum number of characters before the hyphen. The third value is the minimum number of characters after the hyphen.
- `<number> <number>`
- : The first value is the minimum word length before words should be hyphenated. The second value is the minimum number of characters before the hyphen. The minimum number of characters after the hyphen will be set equal to the second value.
- `<number>`
- : The value is the minimum word length before words should be hyphenated. The minimum number of characters before and after the hyphen will be set to `auto`.

If `auto` is set for any of the values, the user agent will choose an appropriate value for the current layout. Unless the user agent can calculate a better value, the following default values will be used:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Probably outside the scope of your PR, but flagging it here: auto needs to be part of the definition list. number can be a single entry that could explain the meaning of one-, two-, three-value cases

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

issue created

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thank you!

Comment thread files/en-us/web/css/reference/properties/image-resolution/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/initial-letter/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/line-height-step/index.md Outdated
Co-authored-by: Dipika Bhattacharya <dipika@foss-community.org>
Comment thread files/en-us/web/css/reference/properties/hyphenate-limit-chars/index.md Outdated

@dipikabh dipikabh left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thanks for the updates!

@dipikabh
dipikabh merged commit a5531a7 into mdn:main Aug 11, 2026
9 checks passed
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.

3 participants