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 #149

Closed
othermaciej opened this issue Dec 21, 2017 · 3 comments
Closed

Update links and layouts to harmonize with revised structure #149

othermaciej opened this issue Dec 21, 2017 · 3 comments

Comments

@othermaciej
Copy link
Contributor

Moved from whatwg/sg#49 on behalf of @geoffcr :

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 21, 2017

Great thoughts.

In general we'd love to redesign the homepage. #90 was an attempt at this; see a preview at https://jsbin.com/cijufadebe/1/edit?html,css,output. We got stuck there because we weren't sure what to do in this new design with the tabbed pages, but my current thinking is that we'd just keep them as-is until someone had a good idea, and at least make the front page much better. I might work on that today a bit.

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.

Personally I think that Workstreams are of less interest to website visitors than the Standards. They're more of an administrative detail. We should probably link to them from the bottom of the Standards page, but I think Standards should stay front and center.

This is somewhat related to whatwg/meta#57.

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?)

I think Working Mode is the most important policy for someone seeking to understand the work done at the WHATWG, and should be given some prominence. But yes, I think a link to the other policies probably deserves some front-page real-estate too.

"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.)

Good ideas!

"Join" takes me straight to the repositories instead of to the participation page. That strikes me as confusing.

I think the link to our GitHub should be framed as, well, a link to GitHub, instead of a link to "Join".

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

For sure, it's a very active locus for the WHATWG community. Check out the logs at https://freenode.logbot.info/whatwg/20171221 to get an idea.

Format

Yeah, not sure what to do there exactly; I wish we had more designers.

Will we see the latest Review Drafts posted on the Living Standard page?

I think that's required in the workstream policy.

@domenic domenic self-assigned this Dec 21, 2017
domenic added a commit that referenced this issue Dec 21, 2017
Closes #90 by subsuming the work there. Helps with #59 as at least the homepage is now mobile-friendly. Helps with some of the items noted in #149.

Substantive changes:

* "Join" renamed to "GitHub" (see #149)
* "News" renamed to "Blog"
* "Working Mode" replaced with "Policies" (see #149)
* "Twitter" added
domenic added a commit that referenced this issue Dec 21, 2017
Closes #90 by subsuming the work there. Helps with #59 as at least the homepage is now mobile-friendly. Helps with some of the items noted in #149.

Substantive changes:

* "Join" renamed to "GitHub" (see #149)
* "News" renamed to "Blog"
* "Working Mode" replaced with "Policies" (see #149)
* "Twitter" added
domenic added a commit that referenced this issue Jan 5, 2018
Closes #90 by subsuming the work there. Helps with #59 as at least the homepage is now mobile-friendly. Helps with some of the items noted in #149.

Substantive changes:

* "Join" renamed to "GitHub" (see #149)
* "News" renamed to "Blog"
* "Working Mode" replaced with "Policies" (see #149)
* "Twitter" added
domenic added a commit that referenced this issue Jan 8, 2018
Closes #90 by subsuming the work there. Helps with #59 as at least the homepage is now mobile-friendly. Helps with some of the items noted in #149.

Non-stylistic changes:

* "Join" renamed to "GitHub" (see #149)
* "News" renamed to "Blog"
* "Working Mode" replaced with "Policies" (see #149)
* "Twitter" added
domenic added a commit that referenced this issue Feb 16, 2018
Closes #21. Closes #59. Closes #178. Closes #180. Helps with #149.
@domenic
Copy link
Member

domenic commented May 3, 2018

Most of this has been addressed in the site redesign. I think what remains is

"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.)

@domenic domenic removed their assignment May 9, 2018
@annevk
Copy link
Member

annevk commented Mar 10, 2020

I'm okay with the status quo with regards to that. In particular, it reads:

To participate in the WHATWG and help develop standards and tests, please read the Code of Conduct and Working Mode. Then, sign the Participant Agreement.

And the Participation Agreement spells out the policies in effect a couple of times.

@annevk annevk closed this as completed Mar 10, 2020
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