From: Francis Hwang <sera@...>
Date: 2005-02-18T11:00:26+09:00
Subject: Re: Ruby Visual Identity Team


On Feb 17, 2005, at 8:32 PM, James Britt wrote:

> I'm moving the news blog off the main page; I just don't see that as 
> main service of the site.  I believe more people are getting such news 
> and updates from RSS feeds. It's become too much work to manually 
> track each new Ruby doc resource, and there is very little report 
> concerning either the documentation project or documentation tools 
> (which is pretty much the original purpose of the site).
>
> I believe that people have two main issues with Ruby documentation: 
> either it just doesn't exist, or they can't find it (or don't even 
> know about it).  Yet there is a boatload of information out there.  
> Not just formal API docs, how-tos, or articles, but blogs and wikis 
> and whathaveyou.  Ruby-doc can best serve users by helping connect 
> developers to docs; the news blog stuff is now pretty incidental.
>
> I also don't see the site as being driven by novelty; it's a more of 
> service or tool.

Makes sense. I guess if you want a Ruby-wide news feed you can 
subscribe to the Artima Ruby Buzz feed, or the del.icio.us ruby tag or 
whatever.

>>> Each box shows resources culled from links posted to del.icio.us. 
>>> Clicking the resource name just loads that page.  Clicking the 
>>> little 'i' next to a resource shows you what people have posted it 
>>> and their extended comments.  A modern browser is required.  Haven't 
>>> tested in older browsers (or even many current ones), so field 
>>> reports are welcome so that it degrades nicely
>> This can be done outside of a given web page, using the Tasty 
>> bookmarklet:
>> http://enthusiasm.cozy.org/archives/2004/07/tasty-redux
>
> Ah, quite nice.  This presumes, though, that the data will always come 
> from, or only come from, a given source.  You also have to have a 
> given browser and install an extension to use this.

I don't think it's browser-specific; I use Safari and just dragged the 
link into my bookmarks bar. (Along with bookmarklets pointing to 
Ping-o-matic, Technorati, del.icio.us itself, etc.) But you do have to 
be aware of it and how bookmarklets work, which I'll readily concede is 
pretty obscure stuff.

Oh, one other thing: Personally, I think iframes look pretty awful, 
unless you can guarantee that they'll never scroll. Trying to do what 
you're doing, going without will take more work -- you'd probably end 
up parsing del.icio.us's info directly in Javascript, I think -- so 
maybe it's not really worth it to make it pretty.

Thanks again for offering ruby-doc,

Francis Hwang
http://fhwang.net/