[Docutils-develop] Re: Web-directories for releases

[Felix W. <Fel...@gm...>]

David Goodger wrote:

> Felix Wiemann wrote:
>
>>> The directory itself and an index.txt file could be created in the
>>> "web" CVS module, and the release tarball could simply be
>>> un-tar.gz'd manually; no need to add it all to CVS.
>>
>> Is an index.txt really needed?
>
> It may be useful, to document what's in the release more briefly than
> in the HISTORY file.  It will become cumbersome to list several
> releases' features on the home page.

OK.  Then we will use it as soon as we split up the main web page, yes?

>> What should be stored in the main web tree (like
>> <http://docutils.sourceforge.net/FAQ.html>)?  The most current
>> revision from CVS?  Or the most current released version
>> (i.e. 0.3.3)?  Or the current stable version (0.3)?  (Personally,
>> I'd prefer one of the latter solutions -- using CVS versions turns
>> out to be bad as soon as incompatible changes are incorporated.)
>
> I've been operating under the (perhaps mistaken) assumption that most
> people are using the latest code from CVS.

I think it *is* mistaken.  Users coming to docutils.sf.net won't dare
downloading a snapshot, and the distributions don't ship snapshots
anyway.

> If that's not the case, then perhaps the files from CVS should reside
> under a different directory.
>
> Proposal: we'll have a "current" directory which is a symbolic link to
> the latest release (0.3.3), and top-level files & directories
> (README.txt & .html, docs, spec, etc.) are symbolic links to the
> corresponding files/directories in "current".

And "stable", linking to 0.3.

> Then when the latest release changes, a single change (ln -s 0.x.y
> current) will update everything.  In parallel, we'll have a
> development directory ("dev"?  "latest"?) that's updated automatically
> from CVS.

Maybe "cvs"?

So we would have the following directories in the webroot?

0.3
0.3.3
dev/latest/cvs
current -> 0.3.3
stable -> 0.3

>> (There is in fact not much point in having Python source files
>> available via web.)
>
> I found it very useful during PyCon; I could use anybody's browser to
> give an overview of the code.  But we don't need more than one copy
> (the latest from CVS).

Ah, OK.

-- 
When replying to my email address, ensure that the mail header contains
'Felix Wiemann'. Please don't send unrequested mails > 64 KB.

<http://www.ososo.de/>