Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New css module: CSS syntax. Partially deprecated charset. #30793

Closed
wants to merge 29 commits into from

Conversation

estelle
Copy link
Member

@estelle estelle commented Dec 5, 2023

The original task was to update the charset module. Turns out there is no such thing.
Charset was defined in CSS 2 but removed in the CSS syntax module.

  • Move css_charset to css_syntax.
  • Created a new document: css_syntax. This is a module landing page. It include the key concepts introduced in that module.
  • Created a new document: a guide on CSS error handling by the parser. a subpage for CSS syntax.
  • Updated the @charset page to indicate that it is NOT an at-rule, and has been deprecated in css-syntax.
  • Updated custom-ident, the page that had the best explanation of CSS escape characters, adding a separate section for escaping characters in CSS. This PR does not include creating links to that section. That will be done as a separate PR (this PR is already big enough)

related to openwebdocs/project#186

@estelle estelle requested review from a team as code owners December 5, 2023 09:08
@estelle estelle requested review from dipikabh and removed request for a team December 5, 2023 09:08
@github-actions github-actions bot added the Content:CSS Cascading Style Sheets docs label Dec 5, 2023
Copy link
Contributor

github-actions bot commented Dec 5, 2023

Preview URLs

External URLs (1)

URL: /en-US/docs/Web/CSS/custom-ident
Title: <custom-ident>

(comment last updated: 2023-12-15 06:03:04)

@teoli2003
Copy link
Contributor

I have a question: browsers are supporting @charset means they don't complain about the syntax but ignore it or are they actually doing something different if we have @charset "UTF-8" and `@charset "iso-8859-15"?

@dipikabh dipikabh self-assigned this Dec 7, 2023
@estelle
Copy link
Member Author

estelle commented Dec 7, 2023

I have a question: browsers are supporting @charset means they don't complain about the syntax but ignore it or are they actually doing something different if we have @charset "UTF-8" and `@charset "iso-8859-15"?

It's been removed from the specification, so it's not in the module other than to say it's not needed, so not including it in the ist of properties introduced or defined in the specification/module. Added a sentence to the charset page, so people know the status, but it's in all browsers, so the deprecation is a spec thing, not an implementation thing.... yet.

dipikabh

This comment was marked as resolved.

dipikabh

This comment was marked as resolved.

files/en-us/web/css/css_syntax/error_handling/index.md Outdated Show resolved Hide resolved
files/en-us/web/css/css_syntax/error_handling/index.md Outdated Show resolved Hide resolved
files/en-us/web/css/css_syntax/error_handling/index.md Outdated Show resolved Hide resolved
files/en-us/web/css/css_syntax/error_handling/index.md Outdated Show resolved Hide resolved
files/en-us/web/css/css_syntax/error_handling/index.md Outdated Show resolved Hide resolved
files/en-us/web/css/css_syntax/error_handling/index.md Outdated Show resolved Hide resolved
files/en-us/web/css/@charset/index.md Outdated Show resolved Hide resolved
files/en-us/web/css/css_syntax/error_handling/index.md Outdated Show resolved Hide resolved
files/en-us/web/css/css_syntax/index.md Show resolved Hide resolved
files/en-us/web/css/custom-ident/index.md Outdated Show resolved Hide resolved
Co-authored-by: Dipika Bhattacharya <[email protected]>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@dipikabh dipikabh removed their assignment Dec 15, 2023
estelle and others added 3 commits December 14, 2023 16:59
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@dipikabh dipikabh dismissed their stale review December 15, 2023 05:35

Unblocking the review on this one as I am going to be away for a bit

@estelle estelle closed this Dec 15, 2023
chrisdavidmills added a commit that referenced this pull request Dec 19, 2023
* New page: CSS syntax error handling

* deprecate @charset and list as a rule not at-rule

* Define character encoding

* New page: error handling

* New page: css syntax module

* delete charset module. move to syntax module

* still supported

* table of contents

* better grammar

* better grammar

* better grammar

* better grammar

* Apply suggestions from code review

Co-authored-by: Dipika Bhattacharya <[email protected]>

* added a few more notes - prefixes

* edits per review

* change h2 to h3

* Apply suggestions from code review

Co-authored-by: Dipika Bhattacharya <[email protected]>

* add guide to module page.

* change UA to browser

* address #30793 (comment)

* hyphens to underscores

* rewrote the at-rule section

* rewrite grammar section

* fixing linter suggestions

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

* final tweaks

* Update files/en-us/web/css/css_syntax/error_handling/index.md

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

* Update files/en-us/web/css/css_syntax/error_handling/index.md

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

* fix flaws

* closed comments

* borked so fixed

* trailing spaces

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

* Update files/en-us/web/css/css_syntax/error_handling/index.md

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

* Update files/en-us/web/css/css_syntax/index.md

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

* Small punctuation fixes

* Apply suggestions from code review

Co-authored-by: Chris Mills <[email protected]>

* header for at-rule

* updates based on review feedback

* link to display property

* Apply suggestions from code review

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

* Update files/en-us/web/css/css_syntax/error_handling/index.md

* Update files/en-us/web/css/css_syntax/index.md

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

* Fix broken links

* typo fix

---------

Co-authored-by: Dipika Bhattacharya <[email protected]>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Chris Mills <[email protected]>
dipikabh added a commit to dipikabh/content that referenced this pull request Jan 17, 2024
* New page: CSS syntax error handling

* deprecate @charset and list as a rule not at-rule

* Define character encoding

* New page: error handling

* New page: css syntax module

* delete charset module. move to syntax module

* still supported

* table of contents

* better grammar

* better grammar

* better grammar

* better grammar

* Apply suggestions from code review

Co-authored-by: Dipika Bhattacharya <[email protected]>

* added a few more notes - prefixes

* edits per review

* change h2 to h3

* Apply suggestions from code review

Co-authored-by: Dipika Bhattacharya <[email protected]>

* add guide to module page.

* change UA to browser

* address mdn#30793 (comment)

* hyphens to underscores

* rewrote the at-rule section

* rewrite grammar section

* fixing linter suggestions

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

* final tweaks

* Update files/en-us/web/css/css_syntax/error_handling/index.md

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

* Update files/en-us/web/css/css_syntax/error_handling/index.md

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

* fix flaws

* closed comments

* borked so fixed

* trailing spaces

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

* Update files/en-us/web/css/css_syntax/error_handling/index.md

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

* Update files/en-us/web/css/css_syntax/index.md

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

* Small punctuation fixes

* Apply suggestions from code review

Co-authored-by: Chris Mills <[email protected]>

* header for at-rule

* updates based on review feedback

* link to display property

* Apply suggestions from code review

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

* Update files/en-us/web/css/css_syntax/error_handling/index.md

* Update files/en-us/web/css/css_syntax/index.md

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

* Fix broken links

* typo fix

---------

Co-authored-by: Dipika Bhattacharya <[email protected]>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Chris Mills <[email protected]>
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
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants