Download Firefox: WindowsMac OS X
logo       
Google Custom Search
    AddThis Social Bookmark Button

Re: [ANN] Early beta verison of a rewrite of ruby-doc.org: msg#00010

Subject: Re: [ANN] Early beta verison of a rewrite of ruby-doc.org
When I click on the site, I get a Site/User Administrator login screen.

Steve

On Nov 9, 2004, at 9:07 AM, James Britt wrote:

Gavin Sinclair wrote:
On Tuesday, November 9, 2004, 4:01:36 PM, James wrote:
Hey all,
I've been working on a redesign and rewrite of ruby-doc.org.
I've set up a beta site on a dummy domain out on the same box where the real site lives. The choice of bogus domain name may change (in retrospect, www.example.com might have been better if less colorful choice to ensure no conflicts).
To see it, add this to your hosts file:
207.44.216.66   www.beta-site.com
You can view the main page here:
  http://www.beta-site.com
Just a quick ACK to say the site looks generally good and I'll make
detailed comments when I get a chance.

Thanks.

Some pre-commenting comments:

The "more ..." links for each of the topic-specific boxes on the main page do not work. The goal is that each box dynamically renders a set of items related to a given topic, with the "more ..." link going to a page that gives the full list. That full list should be derived from the some engine that drives the RSS feeds and the /navigate page.

The selection of facets and topics for which to categorize documentation and resources is tricky, and as I've been going through this run into various cases where I felt navigation or selection was awkward or incomplete. On the other hand, getting this "just right" may take more than than it is worth; I'm applying an 80/20 rule approach here such that one should at least be able to winnow a large list of resources down to a handful, where it becomes reasonable to scan titles and make a selection.

A big issue, which is likely not apparent when looking at the site, is how new items are added. I've been experimenting with different ways to so auto-classification, again trying to find some 80/20 balance.

If you saw or heard my RubyConf2004 talk, I was using some explicit HTML/CSS markup to embed facet/topic tagging. Over time, though, I've found this to be too troublesome to ensure consistent use. I will likely fall back to some modified form of keyword indexing.


James






<Prev in Thread] Current Thread [Next in Thread>