I like the new ruby-doc.org!

Alan G. wrote:

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 B.

http://www.ruby-doc.org - Ruby Help & Documentation
Ruby Code & Style - 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

On Jan 25, 2006, at 5:21 PM, James B. wrote:

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… :D)

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 G. II

Alan G. wrote:

[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 Edward G. 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 B.

Rich M. wrote:

James B. wrote:

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.

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

James B. wrote:

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

Technical editing and writing, programming, and web development:
http://www.cfcl.com/rdm/resume

Contact information: [email protected], +1 650-873-7841

James B. [email protected] wrote:

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 Bookmarklets for Zapping Annoyances

On Thu, 2006-01-26 at 08:21 +0900, James B. wrote:

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 :slight_smile:

Zach D. wrote:

James Edward G. II wrote:

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!

That would be Dan Ritz of 30 Second Rule.


James B.

http://www.ruby-doc.org - Ruby Help & Documentation
Ruby Code & Style - 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 G. II wrote:

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