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

Suggestion: Use canonical spelling of other web standards #7159

Open
j9t opened this issue Oct 5, 2021 · 2 comments
Open

Suggestion: Use canonical spelling of other web standards #7159

j9t opened this issue Oct 5, 2021 · 2 comments
Labels
clarification Standard could be clearer

Comments

@j9t
Copy link
Contributor

j9t commented Oct 5, 2021

In the copy (that is, not in references), the specification speaks of standards “HTML2”, “HTML4,” or “DOM2”. This is a noticeable difference to how the standards are officially called and being referred to (“HTML 2” or “HTML 2.0”, “HTML 4”, or “HTML 4.01”, “DOM 2” or “DOM Level 2”).

That similar standards (like “HTML 3.0” and “HTML 3.2”) are referred to like these standards are usually being called, suggests that this is accidental, at least that there’s inconsistency.

I suggest to use the names of the respective standards as they are named or as they are commonly called. (I volunteer to look prepare a PR addressing this, too.)

@annevk annevk added the clarification Standard could be clearer label Oct 6, 2021
@annevk
Copy link
Member

annevk commented Oct 6, 2021

This is primarily section 1.6, no?

I suspect this was done to align with HTML5: https://blog.whatwg.org/spelling-html5.

Also, it's a bit unclear to me what canonical would be here, e.g., https://www.w3.org/TR/html401/ has "HTML 4.01 Specification", which is not how I'd want to refer to that.

(I also personally prefer the no space style, but not enough to attempt to block changes.)

@j9t
Copy link
Contributor Author

j9t commented Oct 6, 2021

Also, it's a bit unclear to me what canonical would be here, e.g., https://www.w3.org/TR/html401/ has "HTML 4.01 Specification", which is not how I'd want to refer to that.

Wasn’t sure how to best describe—here, I’d suggest “HTML 4.01”. I believe that’s how most people refer to and write about this specification.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
clarification Standard could be clearer
Development

No branches or pull requests

2 participants