lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Grant Ingersoll <>
Subject Re: [jira] Commented: (LUCENE-805) New Lucene Demo
Date Mon, 19 Feb 2007 19:12:56 GMT

On Feb 19, 2007, at 1:17 PM, Doron Cohen wrote:

> So docs moved to wiki would be removed from svn, right?

Yes.  To transition, the links would be changed to link into the Wiki.

> This also means that the recently added nice 'docs by release'
> views would only exist for Javadocs and FileFormats. Perhaps
> having query-syntax by release would also be helpful for users.

Yeah, query-syntax is pretty static, so that would be fine, but I  
sense a slippery slope here.  Scoring is static, too, but I think if  
people want to add to the scoring doc, that would be fine.  Part of  
me feels like it should be all the docs, including the file formats b/ 
c we are trying to encourage people to document.  On the other hand,  
some parts of the docs, like the file formats and query-syntax, feel  
more in stone to me and I can see a case that they should only be  
changed through a patch approach so that a committer is reviewing the  
changes.  I guess the question is, if we switch to all wiki approach,  
do people, especially committers, feel that changes that contain  
errors will be caught and fixed.  Perhaps we would want to change the  
wiki policy to notify java-dev or java-commits when there are  
changes?  I'm not sure how the wiki is administered or if I'm missing  
the notifications already.

Having spent some of the weekend looking through Solr's docs, I'm  
quite impressed with what they have done through the wiki.  It is  
very well organized and seems to cover a lot of ground in a nice,  
coherent manner, so that makes me in favor of putting all the files,  
including File Formats into the wiki and setting it so that we are  
some how notified of changes.

>>> -Grant
> ---------------------------------------------------------------------
> To unsubscribe, e-mail:
> For additional commands, e-mail:

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message