+1 for more asciidoc guides. I find these to be extremely useful anytime I run across these on projects.
I'd be happy to add developer level docs in Streaming Expressions / Math Expressions. Joel Bernstein http://joelsolr.blogspot.com/ On Mon, Jun 17, 2019 at 4:18 PM Jan Høydahl <[email protected]> wrote: > Hi devs, > > Today we have mainly two sources of developer documentation (apart from > Javadoc and refGuide): > > * The websites. Very short instructions and linking to WIKI for in-depth > * The old Moin wikis at wiki.apache.org with more details > > Soon the old Moin wiki is being discontinued and I plan to migrate that > content to Confluence this week, see > https://issues.apache.org/jira/browse/LUCENE-8858 and > https://issues.apache.org/jira/browse/SOLR-13548 > > So the first step will be to just start using Confluence instead of Moin. > Help appreciated with the cleanup once the first migration is done in the > two JIRAs above. A LOT of the content in old WIKIs is outdated and a big > cleanup once this is in Confluence is highly needed! > > > Someone has also suggested to move most developer resources found in the > WIKI into the main GIT code tree, so you have it right there with your git > clone. What I want to discuss here is more detailed how that would look > like and what info to move over. > > One idea is to create one or more Asciidoc guides in the source tree, e.g > > * /dev-docs : Common info i.e. Git, Pull requests, building, doing > releases etc. Publish in TLP site > * /lucene/dev-guide : Lucene-specific developer content. Publish in Lucene > web site > * /solr/dev-guide : Solr-specific developer content. Publish in Solr web > site > > These will be built with Jekyll by Jenkins, into nice HTML guides and > published to the web sites. > > There may be other ways to do this as well, such as creating a new git > repo for dev docs, but I think people have good experience from Solr's > ref-guide with keeping code and docs in sync. What do you think? > > -- > Jan Høydahl, search solution architect > Cominvent AS - www.cominvent.com > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > >
