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

[Editorial] "state" keywords have inconsistent casing #10802

Open
keithamus opened this issue Nov 27, 2024 · 3 comments
Open

[Editorial] "state" keywords have inconsistent casing #10802

keithamus opened this issue Nov 27, 2024 · 3 comments
Labels
editorial Changes that do not affect how the standard is understood good first issue Ideal for someone new to a WHATWG standard or software project

Comments

@keithamus
Copy link
Contributor

keithamus commented Nov 27, 2024

What is the issue with the HTML Standard?

Some states, such as input's type and img's loading are title case. Many others are not.

I'm filing this issue to track work to change all states to be title case.

How would someone contribute to this issue?

  1. You can fork and clone the HTML spec: git clone [email protected]:<your-username>/html
  2. Edit the source file in your favourite editor.
  3. Look for "states" in lowercase, you can find all instances with this shell command: grep 'attr-.*-state">[a-z]' source.
  4. Pick one to zero in on, for example attr-translate-yes-state & attr-translate-no-state are both (at the time of writing) not in title case.
  5. In your editor search for all instances of your chosen attributes, and reformat them to be title case: the first letter and subsequent "proper nouns" should have be in upper case, all verbs and common nouns need to be in lower case.
  6. Commit your changes with a sensible message: "git commit -am'editorial: use title case for `
  7. Push your changes to your fork; git push
  8. Raise a pull request and make the title of the PR match your commit message.
@keithamus keithamus added the editorial Changes that do not affect how the standard is understood label Nov 27, 2024
@domenic
Copy link
Member

domenic commented Nov 28, 2024

Somewhat of a dupe of #9832 (comment), but a dedicated tracking issue is reasonable.

@annevk
Copy link
Member

annevk commented Nov 28, 2024

Yeah, and it has come up in reviews since then. FWIW, I have come around to Title Case for these. It sets them clearly apart from the keywords and other concepts.

@HarshitGourlariya
Copy link

The issue is solved in the PR #11027

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
editorial Changes that do not affect how the standard is understood good first issue Ideal for someone new to a WHATWG standard or software project
Development

No branches or pull requests

4 participants