Formal syntax wrong

[jimmonte]

MDN URL

https://developer.mozilla.org/en-US/docs/Web/CSS/font-size-adjust

What specific section or headline is this issue about?

Formal syntax

What information was incorrect, unhelpful, or incomplete?

Formal syntax should optionally include ex-height | cap-height | ch-width | ic-width | ic-height

What did you expect to see?

See above

Do you have any supporting links, references, or citations?

View link given on page for reference

Do you have anything more you want to share?

No response

MDN metadata

Page report details

• Folder: en-us/web/css/font-size-adjust
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/CSS/font-size-adjust
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/css/font-size-adjust/index.md
• Last commit: c77cfcd
• Document last modified: 2023-07-20T07:38:29.000Z

[wbamberg]

This is because the algorithm we use to get the CSS syntax explicitly excludes numbered versions of the specs, and considers the unnumbered version to be the "current spec": mdn/yari#4656 (comment).

I'm not sure if this is a good policy or not, though, and it's unfortunate that the policy is different in BCD, which supplies the URL that appears in the "Specifications" section :(.

[wbamberg]

I've started a discussion -> https://github.com/orgs/mdn/discussions/442

[OnkarRuikar]

It doesn't matter in this case, just for info, we are stuck on an 9 month old version of @webref/css(v6.7.1) package:

• chore(deps): bump @webref/css from 5.4.4 to 6.6.2 yari#9285

[wbamberg]

Yes, although as you say that is not relevant to this issue. I think it would be great if Yari extracted the csssyntax code to a separate package, and I have made a start at this in https://www.npmjs.com/package/query-css-syntax, which supports webref 6 and is what I am using for content embedding. But I don't know if Yari wants to do that.

[OnkarRuikar]

I have made a start at this in npmjs.com/package/query-css-syntax, which supports webref 6

It would be really great if webref provided these easy retrieval APIs out of the box.

[bsmth]

We are stuck on an 9 month old version of @webref/css(v6.7.1) package

There's a PR to upgrade to 6.0.0 here:

• chore(deps): bump @webref/css from 5.4.4 to 6.0.0 yari#9621

[teoli2003]

We discussed it today. We agree that this is a problem we want to solve, but it is a complex one. So, we are closing this but in favor of the discussion at https://github.com/orgs/mdn/discussions/442