This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 10646 - Home page is not general-public-friendly
Summary: Home page is not general-public-friendly
Status: NEW
Alias: None
Product: HTML WG
Classification: Unclassified
Component: website for HTML WG (show other bugs)
Version: unspecified
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: This bug has no owner yet - up for the taking
QA Contact: HTML WG Bugzilla archive list
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-09-17 16:10 UTC by Bijan Parsia
Modified: 2010-09-17 18:55 UTC (History)
4 users (show)

See Also:


Attachments

Description Bijan Parsia 2010-09-17 16:10:46 UTC
http://lists.w3.org/Archives/Public/public-html-comments/2010Sep/0013.html

(Copied below)

I'd just like to draw attention to some posts by Shelley providing  
support for commenting on the specs:
	http://realtech.burningbird.net/reviewcomment-w3c-html5-specification
	http://realtech.burningbird.net/how-comment-and-when
	http://realtech.burningbird.net/reviewcomment-w3c-html5-specification/html5-document-structure

I think these are really good and helpful, esp. for people new to the  
spec and the W3C. One thing I notice about the HTMLWG's home page:
	http://www.w3.org/html/wg/
is that it's *not* particularly friendly to such an audience (it's a  
more typical working WG page; there's not even a list of links to  
tutorials, or to these wikipedia pages:
	http://en.wikipedia.org/wiki/HTML5
	http://en.wikipedia.org/wiki/Comparison_of_layout_engines_(HTML5)
something akin to the latter will be invaluable).

Given the wide and diverse reviewers expected and desired for last  
call, I think it would be very good to have a more friendly entry  
point. I know there are other sources of friendliness, so I don't  
think it necessarily requires a huge chunk of work on the WG's part.
Comment 1 Sam Ruby 2010-09-17 17:04:29 UTC
I'm looking for concrete suggestions.

Are we talking about replacing the front page with the content from that page?  Adding a few paragraphs (and links) to the front page?
Comment 2 Bijan Parsia 2010-09-17 17:29:51 UTC
(In reply to comment #1)
> I'm looking for concrete suggestions.
> 
> Are we talking about replacing the front page with the content from that page? 
> Adding a few paragraphs (and links) to the front page?

I don't know if I can usefully dictate a design from bug comments, but let me just compare with two other pages:

http://www.w3.org/XML/Query/
http://www.whatwg.org/

Both are pretty clearly much more inviting than the HTMLWG page. (Though neither are my ideal.)

So,

1) The current page should not be the front page. It's really an internal wg page. I suggest replacing it with either a navigation like interface (a la the WHATWG page), or a richer page still geared at a general audience (a la the XQuery page).

2) I think have a short list of "key external resources people might find helpful" would be a good page to have.

3) I think having a "reviewers and commenters guide" on the model of Shelley's would also be very useful in general and especially when going to last call. (I founding having a guide on *how* to comment and another on *what to comment on* particularly helpful.)

Is this more helpful?
Comment 3 Sam Ruby 2010-09-17 18:55:04 UTC
(In reply to comment #2)
> (In reply to comment #1)
> > I'm looking for concrete suggestions.
> > 
> > Are we talking about replacing the front page with the content from that page? 
> > Adding a few paragraphs (and links) to the front page?
> 
> I don't know if I can usefully dictate a design from bug comments, but let me
> just compare with two other pages:
> 
> http://www.w3.org/XML/Query/
> http://www.whatwg.org/
> 
> Both are pretty clearly much more inviting than the HTMLWG page. (Though
> neither are my ideal.)
> 
> So,
> 
> 1) The current page should not be the front page. It's really an internal wg
> page. I suggest replacing it with either a navigation like interface (a la the
> WHATWG page), or a richer page still geared at a general audience (a la the
> XQuery page).

Just to be clear, the home page is <http://www.w3.org/html/>.   <http://www.w3.org/html/wg/> is intended to be an internal wg page.  From the internal WG page, you can get to the home page by clicking on the link at the top of the page.  There is a link back near the bottom of the list on the right, in a smaller font.

The home page itself is currently structured as a blog on the left, and contains a navigation aide on the right.  The links on the right tend to lead to the wiki.

I have no doubt that both can be improved, and that the visibility of the "real" home page could be improved.

> 2) I think have a short list of "key external resources people might find
> helpful" would be a good page to have.

"Learn" contains some links.  As do the other wiki pages.  Feel free to add more.  Or to suggest other organizations for the home page.

> 3) I think having a "reviewers and commenters guide" on the model of Shelley's
> would also be very useful in general and especially when going to last call. (I
> founding having a guide on *how* to comment and another on *what to comment on*
> particularly helpful.)

My preference is that such find its way onto the wiki and is also collaboratively edited.  But that is just a preference.

> Is this more helpful?

Yes.