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: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
