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

Update links and layouts to harmonize with revised structure #49

Closed
geoffcr opened this issue Dec 16, 2017 · 8 comments
Closed

Update links and layouts to harmonize with revised structure #49

geoffcr opened this issue Dec 16, 2017 · 8 comments

Comments

@geoffcr
Copy link

geoffcr commented Dec 16, 2017

I realize that the front page of the WHATWG at https://whatwg.org/ has "history" and is not likely to change, but - to a novice user - there are some confusing elements to how the links are laid out (and some of the terminology). Here are several - some significant, some less so:

Workstreams
Where do I find a list of Workstreams? Oh - Standards; we don't call them "Workstreams" anywhere, so far as I can tell. That should presumably be fixed.
(We also might want to change the "Standards" block to say "See the other Living Standards developed at the WHATWG".)

Policies
Where do I find Policies? Oh - if I click on FAQ, Standards, or Participate, there's also a "Policies" tab at the top. Policies deserve a link from the main page, along with Standards and FAQ. ("Working Mode" has its own front-page button, even though it's now a subset of Policies; perhaps that should be swapped out and replaced with Policies?)

Signing up
"Participate" takes me to a nice narrative page, but please point people to the governing Workstream Policy and IPR Policy in addition to the Code of Conduct and the Working Mode. (This strikes me as significant.)
"Join" takes me straight to the repositories instead of to the participation page. That strikes me as confusing.

IRC
Do people still use IRC? (In other words, does it merit front-page real estate?)

Format
This is just a visual nit, but it's disorienting (to me) to fly from the "Nine Colored Blocks" front page to a "Traditional Tabbed" Standards/FAQ/Policies/Participate page, or to the Living Standards in a cleaner HTML presentation. Not sure what to fix, except perhaps to ensure that there's a consistent relationship between the tabbed pages and the front page.

Review Drafts
Will we see the latest Review Drafts posted on the Living Standard page? For example, https://html.spec.whatwg.org/multipage/ has links to the one-page version, multipage version, developer version, translations, etc. Will there also be a "Latest Review Draft" button? (I would think so; otherwise, non-technical lawyers are going to have a hard time finding it in the repository.)

@domenic
Copy link
Member

domenic commented Dec 16, 2017

FYI this is probably not a matter for the Steering Group, but instead something to be opened on https://github.com/whatwg/whatwg.org. Do you mind if we move the issue there?

@geoffcr
Copy link
Author

geoffcr commented Dec 18, 2017

Sure - my suggestion would be for the SG to consider this, figure out what makes sense, and then move the issue over. (My raw notes aren't well-framed enough, I wouldn't think, for a copy/paste.)

@domenic
Copy link
Member

domenic commented Dec 18, 2017

The issue is that, while the SG presumably has some final say over the website, it's mostly maintained by the community, so it's better to raise these issues in a forum where the community is paying attention. That way, we can leave whatwg/sg for specific escalations that need SG attention (e.g. if you as a community member feel the website maintainers are not being responsive and the SG needs to step in and mediate your dispute).

This is similar to how you wouldn't immediately open an issue on whatwg/sg if you had a suggested change to a living standard.

@geoffcr
Copy link
Author

geoffcr commented Dec 18, 2017

Thanks. Most of these strike me as structural fixes of the kind we might have addressed as pre-Launch items if we hadn't been busy otherwise - e.g., Standards=>Workstreams, and Standards=>Living Standards, and Working Mode=>Policies; it would seem weird for me to post something in the public venue saying "Update front page to match updated terms".

It's not the most important stuff out there, certainly, just confusing to folks who are wondering how to map the updated process to the front page.

I'll hold on to these for now and perhaps can consider posting them later if the SG doesn't undertake to modify things.

@othermaciej
Copy link
Contributor

I agree with @domenic that this issue should really be in the whatwg/whatwg.org repo rather than in whatwg/sg. The SG would be happy to provide input, but I think execution and design details can be left to the existing whatwg.org website maintainers.

@othermaciej
Copy link
Contributor

@dbaron @henceproved @michaelchampion can you confirm that you agree with leaving these site organization changes up to the whatwg.org website maintainers (and thus we could close this issue and file a new one with same contents in whatwg/whatwg.org)?

@henceproved
Copy link
Contributor

Totally agree with leaving these change to the website maintainers, and moving this issue to the whatwg/whatwg.org repo.

@othermaciej
Copy link
Contributor

Looks like we have consensus, so moved to whatwg/whatwg.org#149

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

No branches or pull requests

4 participants