: > Things under contrib have entries here:
: > http://lucene.apache.org/java/docs/lucene-sandbox/
: >
: Fine, so I can add the gdata server to the sandbox html file or is
: that generated somewhere?

The source files for the Java Lucene website are in in the same subversion
project as the source code (and unless i'm mistaken, the entire site is
included in all releases).  The directories you want to look at are...

http://svn.apache.org/viewvc/lucene/java/trunk/xdocs
http://svn.apache.org/viewvc/lucene/java/trunk/site

...patches to those directories can be submited just like patches to
anything else in the repository.


In my opinion, the best place to start would be with some pages in the
wiki ... that way you can get faster feedback/copy-editing from
the community as a whole.

Anyone who knows me well knows that i generally loath wikis -- in my
opinion writing documentation in HTML isn't that hard, and if it seems
hard, you're trying to put "fancy shit" in your documentation and you
shouldn't do that -- in my day job, i encourage everyone to put all
documentation in HTML in CVS; but working on OSS projects like Lucene with
a large user pase has made me realize how valuable the Wiki editing model
can be in developing documentation (i just wish the wiki editing *syntax*
were html)

Start with Wiki pages, for everything, once you've got some docs fleshed
out that seem like they should be "formal documentation" then you can
promote them into more official (commited, built, released) XHTML
documentation.



-Hoss


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to