Hi folks,
I've more or less completed the software to generate the stdlib
documentation, and am going to release an aplha version (tarball) on
RubyForge soon. I just wanted to get a couple of things straight
first.
First, ruby-doc hosting. Any specific plans, James? I think
http://www.ruby-doc.org/stdlib/index.html
Would be a good URL to access the front page of the documentation.
Nice and easy to remember.
Now, we need a mechanism, as discussed, to upload the latest tarball
to ruby-doc. If I can FTP/scp a tarball, and you create a cronjob
that checks for updates and unpacks it, then we'll be set.
I'm thinking that if you keep that tarball in a known place on
ruby-doc, then I'll provide a link to it from within the documentation
itself so people can easily download it. That implies that the same
name would be used all the time.
It would also be prudent to provide both .tar.gz and .zip files, I
think.
Now, for the rest of you, if you'd like to offer some assistance,
please download the alpha tarball from
http://rubyforge.org/project/showfiles.php?group_id=86
and offer some critiques. My HTML and CSS is absolutely hopeless, so
I'd love some tips, ideas, and outright implementations on how to make
it look better. If you look at the HTML generated for the table of
contents and status report, you'll see hacks and general incompetence.
I haven't put much effort into what wording there is. Feel free to
comment on any aspect you like.
Cheers,
Gavin
|
