Hey there, 2008/8/1 Chris Hostetter <[EMAIL PROTECTED]>:
> I'd hoped to be long done with SOLR-555 by now, have it all polished and > spiffy and committed ... but it's not. Autogenerate "user" docs about "plugins" from code, http://issues.apache.org/jira/browse/SOLR-555 > is it worth it to > start using this, and start generating better documentation that we can > include in 1.3 even if the documentation isn't pretty to look at? Will we > take the time before releasing to fill in the documentation so it's actually > useful? ... or should we hold off, stick with the status quo (all "user" > docs are in wiki pages) and worry about after 1.3? I'd suggest "commit early, commit often", especially for something that is not API-level and therefore problematic if it's changed. This gives other people the opportunity to work on the three things you list that need improvement, and also allows anyone to start writing docs. If lots of docs are added before 1.3, great. If they aren't, no problem. Andrew. -- [EMAIL PROTECTED] / [EMAIL PROTECTED] http://www.andrewsavory.com/
