Skip to content

CSS value intro sentence position#44833

Merged
estelle merged 5 commits into
mainfrom
values
Jul 21, 2026
Merged

CSS value intro sentence position#44833
estelle merged 5 commits into
mainfrom
values

Conversation

@estelle

@estelle estelle commented Jul 20, 2026

Copy link
Copy Markdown
Member

CSS properties include a "Values" section.
Sometimes there is an intro to the values. sometimes there isn't.
Sometimes that intro is above the values title, sometimes it's after it.
This is the first PR in an attempt to make things consistent. This PR addresses all the properties that had a simple sentence preceding the values header that didn't need a whole bunch of other work done and three properties that had a bit more work... mainly moving descriptive text into a description section.

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

github-actions Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor
Preview URLs (56 pages)
Flaws (18)

Note! 48 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/background-image
Title: background-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

URL: /en-US/docs/Web/CSS/Reference/Properties/border-bottom-color
Title: border-bottom-color CSS property
Flaw count: 1

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

URL: /en-US/docs/Web/CSS/Reference/Properties/border-left-color
Title: border-left-color CSS property
Flaw count: 1

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

URL: /en-US/docs/Web/CSS/Reference/Properties/border-right-color
Title: border-right-color CSS property
Flaw count: 1

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

URL: /en-US/docs/Web/CSS/Reference/Properties/border-top-color
Title: border-top-color CSS property
Flaw count: 1

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

URL: /en-US/docs/Web/CSS/Reference/Properties/column-span
Title: column-span 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/transform
Title: transform CSS property
Flaw count: 9

  • macros:
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/zero which doesn't resolve
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/zero which doesn't resolve
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/zero which doesn't resolve
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/zero which doesn't resolve
    • Macro csssyntax produces link /en-US/docs/Web/CSS/Reference/Values/zero which doesn't resolve
    • and 4 more flaws omitted

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

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

(comment last updated: 2026-07-21 11:09:56)

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

Really nice work, @estelle; great to see this inconsistency being tackled.

I've got a few small comments for you, but nothing desperately important. I'll approve it, so you can merge once you're done looking.

Comment thread files/en-us/web/css/reference/properties/aspect-ratio/index.md Outdated

### Values

This property is specified as a single value:

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.

In these cases, you sometimes say "a single value" and sometimes say "one value". Choose one, and make it consistent.

Comment thread files/en-us/web/css/reference/properties/text-decoration-line/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/background-color/index.md Outdated
Comment thread files/en-us/web/css/reference/properties/border-top-color/index.md Outdated
@estelle
estelle merged commit c0c85c3 into main Jul 21, 2026
13 checks passed
@estelle
estelle deleted the values branch July 21, 2026 11:11
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