I like the new ruby-doc.org!

[James Britt]

[obligatory] Anyone have any idea when www.ruby-lang.org will get the
facelift that was designed a while ago [/obligatory]

Trust me, this always takes longer than you expect. Especially when
it's something that gets done "when you have free time."

Sure -- Is it just a time-to-deploy issue or is there additional work
that needs to be done for this? (As far as being able for others to
volunteer some time/code)

Most of the immediate work is tracking down broken links. The site had
become, on the server, a fair mess of files and folders and sym links,
and swapping out pages was far less clean than it should have been.

I will probably write something to crawl the site and give me a link
status report that doesn't bury me in the obvious.

Longer-term I need to add a smarter search facility and a version of the
API docs that allow for user comments; I've started working with RDog (
Nitro/Og application), so if you have knowledge of Nitro/Og/RDog (or are
interested in learning about these things) then I could use a hand on
some things.


Thanks,


James Britt
---
http://www.ruby-doc.org - Ruby Help & Documentation
http://www.artima.com/rubycs/ - The Journal By & For Rubyists
http://www.rubystuff.com - The Ruby Store for Ruby Stuff
http://www.jamesbritt.com - Playing with Better Toys
http://www.30secondrule.com - Building Better Tools

 

[James Edward Gray II]

Most of the immediate work is tracking down broken links. The site
had become, on the server, a fair mess of files and folders and sym
links, and swapping out pages was far less clean than it should
have been.

I will probably write something to crawl the site and give me a
link status report that doesn't bury me in the obvious.

Just FYI, I'm currently reading Higher-Order Perl and one of the
examples was a simple robot framework. The example in the book used
it to find broken links, among other things.

I mention this because I have it mostly ported. The version in the
book obeys /robots.txt and mine doesn't yet, but that's the only
difference at this point. (The used a Perl module to handle the
robot file I can find a Ruby equivalent for. See this Friday's Ruby
Quiz... )

Anyway, if it will help, it's all yours. It'll be on my blog[1] in a
couple of days, but you can email me privately if you want it before
then...

1: http://blog.grayproductions.net/

James Edward Gray II

 

[Rich Morin]

I will probably write something to crawl the site and give
me a link status report that doesn't bury me in the obvious.

For about the same amount of effort, you could install
Swish-e and get both link checking and full-text search.

-r

 

[John W. Long]

[obligatory] Anyone have any idea when www.ruby-lang.org will get the
facelift that was designed a while ago [/obligatory]

It's coming. I'm working full time on the project right now. It may be a
while though. I'm in the middle of writing a custom CMS for the site.
Read more on my blog:

http://wiseheartdesign.com

 

[James Britt]

James Edward Gray II wrote:
...

Anyway, if it will help, it's all yours. It'll be on my blog[1] in a
couple of days, but you can email me privately if you want it before
then...

Thanks. You realize, of course, that all geeks feel compelled to first
write the code themselves.

"It'll be easy! A two-liner! Maybe one."

I mean, so long as there's coffee in the house.


James Britt

 

[James Britt]

For about the same amount of effort, you could install
Swish-e and get both link checking and full-text search.

Yeah, but there's this strong compulsion to eat my own dog food. Or
Ruby's, at least. I'd like to first see if I can get what I want using
only Ruby.


James

 

[Martin DeMello]

Zapping? As in using a Firefox thingy to clear colors?

If I edit the CSS (though Firefox) and remove the background color, I
still see the boxes. But not if I do a 'zap colors'. That seems to
make sense, though.

Yeah, there's a little javascript bookmarklet[1] I use to remove background
colours from a page, since I find them hard to read. Most pages degrade
surprisingly gracefully; ruby-doc almost does, apart from the box issue.
Maybe have an alternate stylesheet without the background colours, then?
I know I'm not the only person who dislikes them.

martin

[1] from http://www.squarefree.com/bookmarklets/zap.html

 

[Ross Bamford]

Longer-term I need to add a smarter search facility and a version of the
API docs that allow for user comments; I've started working with RDog (
Nitro/Og application), so if you have knowledge of Nitro/Og/RDog (or are
interested in learning about these things) then I could use a hand on
some things.

I'm coming to this late, so maybe you already discussed this, but I
notice that the API Wiki links don't work (Internal server error). Is
that the TODO you're referring to above (user comments)?

Very nice job on the new site, btw

 

[Zach Dennis]

Hadn't seen this mentioned here, so just wanted to say that I feel the
new front page of ruby-doc.org is significantly more attractive. Nice
work!

I agree. The new site looks amazing! Great job to whomever did the redesign!

Zach

 

[James Britt]

I agree. The new site looks amazing! Great job to whomever did the
redesign!

That would be Dan Ritz of 30 Second Rule.




--
James Britt

http://www.ruby-doc.org - Ruby Help & Documentation
http://www.artima.com/rubycs/ - The Journal By & For Rubyists
http://www.rubystuff.com - The Ruby Store for Ruby Stuff
http://www.jamesbritt.com - Playing with Better Toys
http://www.30secondrule.com - Building Better Tools