Document `speak-as` CSS property. #37706

younisdev · 2025-01-18T21:52:40Z

Description

Documented the speak-as CSS property as a standalone property, ensuring accuracy, simplicity, and user-friendliness. In addition, edited the title of @counter-style/speak-as from speak-as to speak-as (@counter-style), and removed unnecessary redirect .

Motivation

I made these changes to ensure that the speak-as property is more documented(only documented in one or two websites), allowing developers a wider options for designing their website.These changes help clarify CSS Speech.

Additional details

None

Related issues and pull requests

Fixes #37548

github-actions · 2025-01-18T21:54:25Z

Preview URLs

/en-US/docs/Web/CSS/speak-as

Flaws (11)

URL: /en-US/docs/Web/CSS/speak-as
Title: speak-as
Flaw count: 11

broken_links:
- /en-US/docs/Glossary/screen_reader is ill cased
- /en-US/docs/Web/CSS/Value_definition_syntax#single_bar is a redirect
- /en-US/docs/Web/CSS/Value_definition_syntax#double_bar is a redirect
- /en-US/docs/Web/CSS/Value_definition_syntax#double_bar is a redirect
- /en-US/docs/Web/CSS/Value_definition_syntax#brackets is a redirect
- and 2 more flaws omitted
macros:
- Macro produces link /en-US/docs/Glossary/screen_reader which is a redirect
- Macro produces link /en-US/docs/Web/CSS/initial_value which is a redirect
- Macro produces link /en-US/docs/Web/CSS/inheritance which is a redirect
- Macro produces link /en-US/docs/Web/CSS/computed_value which is a redirect

(comment last updated: 2025-02-26 04:07:42)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

hamishwillee · 2025-01-28T06:26:59Z

@estelle I have removed myself as reviewer as this is a CSS property. Also after my long holiday I am well behind on review tasks.

github-actions · 2025-02-13T17:36:28Z

This pull request has merge conflicts that must be resolved before it can be merged.

skyclouds2001

references:

https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types/CSS_property_page_template
https://drafts.csswg.org/css-speech/#propdef-speak-as
https://github.com/mdn/browser-compat-data/blob/main/css/properties/speak-as.json

files/en-us/web/css/@counter-style/speak-as/index.md

files/en-us/web/css/speak-as/index.md

skyclouds2001 · 2025-02-14T16:21:47Z

files/en-us/web/css/speak-as/index.md

+```CSS
+  .normal {
+    speak-as: normal;
+  }
+
+  .spell-out {
+    speak-as: spell-out;
+  }
+
+  .literal-punctuation {
+    speak-as: literal-punctuation;
+  }
+
+  .no-punctuation {
+    speak-as: no-punctuation;
+  }
+
+  .digits {
+    speak-as: digits;
+  }
+```


similar to the comment under syntax section

#37706 (comment)

Co-authored-by: skyclouds2001 <[email protected]>

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

files/en-us/web/css/speak-as/index.md

Co-authored-by: skyclouds2001 <[email protected]>

Co-authored-by: skyclouds2001 <[email protected]> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: skyclouds2001 <[email protected]>

skyclouds2001 · 2025-02-19T15:12:58Z

CI is saying something about the end-of-line

younisdev · 2025-02-21T07:20:33Z

CI is saying something about the end-of-line

I'll take a look

Josh-Cena · 2025-02-25T02:22:31Z

Make sure that you configure your editor to use LF instead of CRLF as line endings

estelle

Thank you for adding this content. I made some suggestions for you to consider.

files/en-us/web/css/speak-as/index.md

Co-authored-by: Estelle Weyl <[email protected]>

estelle

Thanks! 🎉

files/en-us/web/css/speak-as/index.md

younisdev added 3 commits January 18, 2025 22:40

Document speak-as CSS property.

05f540e

Add redirect for speak-as property

c803264

Clarifying that speak-as is a descriptor at the title section.

757aadd

younisdev requested review from a team as code owners January 18, 2025 21:52

younisdev requested review from estelle and hamishwillee and removed request for a team January 18, 2025 21:52

github-actions bot added Content:CSS Cascading Style Sheets docs size/m [PR only] 51-500 LoC changed labels Jan 18, 2025

younisdev and others added 13 commits January 18, 2025 23:57

fix indentation

0957b5f

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Update files/en-us/web/css/speak-as/index.md

a0c5fe1

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

add a space

ee1f4e0

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Update files/en-us/web/css/speak-as/index.md

828b622

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Update files/en-us/web/css/speak-as/index.md

7aada5b

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Update files/en-us/web/css/speak-as/index.md

c52b788

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

add a space

37c8bae

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Update files/en-us/web/css/speak-as/index.md

a8df1f6

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Add browser compat placeholder

72419ab

Fixed redirect mistake.

88d3703

Update files/en-us/web/css/speak-as/index.md

a5436ee

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Remove unnecessary speak--as redirect.

eea54fe

Merge branch 'main' into update1

70de481

hamishwillee removed their request for review January 28, 2025 06:26

github-actions bot added the merge conflicts 🚧 [PR only] label Feb 13, 2025

skyclouds2001 reviewed Feb 14, 2025

View reviewed changes

younisdev and others added 4 commits February 19, 2025 15:40

add multiple speak-as value syntax

e6878c6

Co-authored-by: skyclouds2001 <[email protected]>

fix a typo

dc4733d

Co-authored-by: skyclouds2001 <[email protected]>

Update files/en-us/web/css/speak-as/index.md

02b747d

Co-authored-by: skyclouds2001 <[email protected]>

Update files/en-us/web/css/speak-as/index.md

5fffcca

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

github-actions bot reviewed Feb 19, 2025

View reviewed changes

files/en-us/web/css/speak-as/index.md Outdated Show resolved Hide resolved

younisdev and others added 3 commits February 19, 2025 16:27

fix title

1d14b87

Co-authored-by: skyclouds2001 <[email protected]>

add 3 changes

a97741e

Co-authored-by: skyclouds2001 <[email protected]> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Update files/en-us/web/css/speak-as/index.md

448e4c6

Co-authored-by: skyclouds2001 <[email protected]>

younisdev and others added 4 commits February 21, 2025 22:36

Fix prettier issue

9fe92ba

Update index.md

b71ed0e

Merge branch 'main' into update1

e075acd

Use the right line endings

4ce32a9

github-actions bot removed the merge conflicts 🚧 [PR only] label Feb 25, 2025

estelle reviewed Feb 25, 2025

View reviewed changes

OnkarRuikar mentioned this pull request Feb 25, 2025

CI: PR review companion doesn't handle redirects well #32501

Closed

younisdev and others added 7 commits February 26, 2025 00:03

Apply introduction review changes.

f4c08ce

Co-authored-by: Estelle Weyl <[email protected]>

Apply Values review changes.

6a44e0f

Co-authored-by: Estelle Weyl <[email protected]>

Apply note section review changes.

1e4bdb1

Co-authored-by: Estelle Weyl <[email protected]>

Apply examples section review changes.

d3c095d

Co-authored-by: Estelle Weyl <[email protected]>

Apply examples-css section review changes.

1f2b334

Co-authored-by: Estelle Weyl <[email protected]>

Apply See also section review changes.

5206dba

Co-authored-by: Estelle Weyl <[email protected]>

Merge branch 'mdn:main' into update1

afc097a

estelle approved these changes Feb 26, 2025

View reviewed changes

files/en-us/web/css/speak-as/index.md Outdated Show resolved Hide resolved

Update files/en-us/web/css/speak-as/index.md

28bf820

estelle merged commit fa09009 into mdn:main Feb 26, 2025
8 checks passed

younisdev mentioned this pull request Feb 27, 2025

Incorrect redirection between speak-as and @counter-style/speak-as CSS properties. #38370

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Document `speak-as` CSS property. #37706

Document `speak-as` CSS property. #37706

younisdev commented Jan 18, 2025 •

edited

Loading

github-actions bot commented Jan 18, 2025 •

edited

Loading

hamishwillee commented Jan 28, 2025

github-actions bot commented Feb 13, 2025

skyclouds2001 left a comment

skyclouds2001 Feb 14, 2025 •

edited

Loading

skyclouds2001 commented Feb 19, 2025

younisdev commented Feb 21, 2025 •

edited

Loading

Josh-Cena commented Feb 25, 2025

estelle left a comment

estelle left a comment

Document speak-as CSS property. #37706

Document speak-as CSS property. #37706

Conversation

younisdev commented Jan 18, 2025 • edited Loading

Description

Motivation

Additional details

Related issues and pull requests

github-actions bot commented Jan 18, 2025 • edited Loading

hamishwillee commented Jan 28, 2025

github-actions bot commented Feb 13, 2025

skyclouds2001 left a comment

Choose a reason for hiding this comment

skyclouds2001 Feb 14, 2025 • edited Loading

Choose a reason for hiding this comment

skyclouds2001 commented Feb 19, 2025

younisdev commented Feb 21, 2025 • edited Loading

Josh-Cena commented Feb 25, 2025

estelle left a comment

Choose a reason for hiding this comment

estelle left a comment

Choose a reason for hiding this comment

Document `speak-as` CSS property. #37706

Document `speak-as` CSS property. #37706

younisdev commented Jan 18, 2025 •

edited

Loading

github-actions bot commented Jan 18, 2025 •

edited

Loading

skyclouds2001 Feb 14, 2025 •

edited

Loading

younisdev commented Feb 21, 2025 •

edited

Loading