On Sunday, November 23, 2003, 2:58:49 PM, jbritt wrote:
> The HTML output from the RDoc comments from Gavin Sinclair's stdlib-doc
> project [0] are online at www.ruby-doc.org [1].
Thanks for getting them up there James.
How do you think we should approach the "downloading" issue? I think
the following URLs are good:
http://www.ruby-doc.org/stdlib/ruby-stdlib-doc.tar.gz
http://www.ruby-doc.org/stdlib/ruby-stdlib-doc.zip
Anyway, it doesn't really matter where they go. As long as I can link
to them from within the online documentation, so people can browse the
docs and download them in two easy steps, then it's fine.
I'm currently trying to master Rake for the purposes of packaging and
uploading.
One issue I haven't given much thought to is package versioning. On
the one hand, it doesn't make much sense to label it 1.1 etc. On the
other, it's probably good for people to know when the file they
downloaded has slipped out of date.
One solution would be date-marking the files (e.g.
ruby-stdlib-doc-2003-11-23.tar.gz). But this makes linking to a
downloadable more difficult.
Any thoughts?
Gavin
|