I will take care of the file formats issue. I thought I updated
before committing, but I obviously missed it.
I would like to move the rest of this discussion to http://
issues.apache.org/jira/browse/LUCENE-708 so it is captured on the
issue, so look for a message from that issue shortly.
On Nov 28, 2006, at 2:00 PM, Doron Cohen wrote:
More then likely the specific changes you asked about were overlooked
when
porting from the old style xdocs directory to the new forrest
directory
structure ...
Should we create an issue for restoring this data in the trunk
version of
the docs?
but even if they weren't how should these changes be
managed? ... the "site trunk" of the needs to be what is published to
the webserver, so that things like the news, and list of
committers can
be
updated on a regular basis ... but how do we reconcile that with
the face
that we want docs like fileformats and query syntax to be "static"
with
the last release?
I think the docs maintained in the repository's trunk/doc should be
up to
date - it has to be in sync with the trunk code. This means, at
least as
long the official Web site docs are for latest official release,
not having
an automatic update of the official Web site that reflects changes to
trunk/doc/*.
I still maintain that the cleanest way to handle things is to say
that
the
"default" site represent the latest greatest documentation --
javadocs
and
forrest generated docs as of hte last nightly build -- with links
to the
"snapshots" of the site for the last N releases using URLs that
make it
clear which release they point at, so...
http://lucene.apache.org/java/docs/fileformats.html
+1, +this site can be automatically update from trunk/doc.
...would be whatever the trunk of that doc says today, but...
http://lucene.apache.org/java/2.0/fileformats.html
This of course should not be updated from trunk/doc.
...would be that document as it existed in the 2.0 release.
-Hoss
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
------------------------------------------------------
Grant Ingersoll
http://www.grantingersoll.com/
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
