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

Meta: make the header more like other WHATWG standards #3010

Open
foolip opened this issue Sep 6, 2017 · 5 comments
Open

Meta: make the header more like other WHATWG standards #3010

foolip opened this issue Sep 6, 2017 · 5 comments

Comments

@foolip
Copy link
Member

foolip commented Sep 6, 2017

https://html.spec.whatwg.org looks like this:
html-header

And https://dom.spec.whatwg.org looks like this:
dom-header

I think HTML would be clearer if organized like our other standards. The bits that don't have obvious place:

  • Multipage Version, One-Page Version, Developer Version and PDF Version. Suggest an "Other versions" heading for those, with multipage highlighted with a bouncing red arrow or something.
  • FAQ, suggest a separate heading.

See also #2906

@foolip
Copy link
Member Author

foolip commented Sep 6, 2017

Extending the current structure to link to web-platform-tests is a bit challenging, which is why this idea first came to mind.

@foolip foolip added the good first issue Ideal for someone new to a WHATWG standard or software project label Sep 6, 2017
@domenic
Copy link
Member

domenic commented Sep 6, 2017

Hmm, I kind of like HTML being special... I'll remove "good first bug" until we have agreement on this.

What's the problem with adding WPTs? Just add another box, right? There's even a commented-out one in the source (legacy open bugs I believe) so that you can stay at an even number of them.

@domenic domenic removed the good first issue Ideal for someone new to a WHATWG standard or software project label Sep 6, 2017
@foolip
Copy link
Member Author

foolip commented Sep 6, 2017

For wpt we'd want to link to at least html/ and "ongoing work" on the html label, but probably also some other directories like 2dcontext and their labels.

When adding things, you have to pay attention to how many boxes there are, their colors and making it look OK, and that kept me from touching them at least.

Do you like it specifically because it makes HTML different, or would you want to make other specs more like HTML?

@domenic
Copy link
Member

domenic commented Sep 6, 2017

Well, I like that HTML is different, and I also think that the other specs' heading styles is not as good as HTML's. But I wouldn't go as far as to say that they should all adopt HTML's.

@foolip
Copy link
Member Author

foolip commented Sep 6, 2017

Filed #3014 for the thing that I wanted most, in cast that can be solved without changing the header boxes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

No branches or pull requests

3 participants