From: timsuth@... (Tim Sutherland)
Date: 2005-01-06T12:46:41+09:00
Subject: Re: Best ways to accelerate Ruby's popularity

In article <41D44401.4060104@mktec.com>, Zach Dennis wrote:
>James Britt wrote:
>
>> 
>> Do you know about www.ruby-doc.org?
>> 
>> Did you browse around there?
>> 
>> What was your experience?
>> 
>
>I don't like how ruby-doc.org's front page is set up. I hate the 
>navigation. You have:
>
>little_link  little_link  little_link
>Content
>
>Content
>
>Content
>
>The links should have a big graphic next to them, or as the link:
>
>===========|
>=API	  =|
>=  DOCS   =|
>=    HERE =|
>===========|
[...]

Just to agree with Zach here...

The links at the top and the sidebar(s) on the right are the only parts of the
page that have to do with Ruby documentation, most of the page is taken up
with announcements and so on.

Maybe move all the announcements to a small sidebar with short summaries?

Also, with the way the announcements (and articles on
http://www.ruby-doc.org/articles/ etc.) are displayed, they feel like
they're all "merging together" visually.

Instead of

  Wed, 6 Oct 2004

   Some Title Goes Here In Light Grey

   Some text ...

How about
  Wed, 6 Oct 2004: Some Title Goes Here In Same Colour as the Date

   Some text ...

The date and title could still be differentiated by one of them being
italicised.

Those issues aside, ruby-doc.org is a great resource. The sidebar on the
right has a lot of good stuff I hadn't noticed before because of the layout.

Cheers :-)