Shoot, the issue is SOLR-12930, not what I wrote
earlier...https://issues.apache.org/jira/browse/SOLR-12930
On Jan 13, 2020, 3:25 PM -0600, Cassandra Targett ,
wrote:
> I’m hoping to resurrect this - I didn’t have time to help out with this last
> Summer, but I’m hoping I have some time now.
I’m hoping to resurrect this - I didn’t have time to help out with this last
Summer, but I’m hoping I have some time now. There was an earlier conversation
about what to do with developer docs back in Oct 2018, so I’ve also updated
SOLR-12940 to use for creating the developer doc structure and
Continuing the discussion about our new dev-docs. Seems to be consensus of
using Asciidoc.
I proposed three separate guides:
> * /dev-docs : Common info i.e. Git, Pull requests, building, doing releases
> etc. Publish in TLP site
> * /lucene/dev-guide : Lucene-specific developer content.
Moin wiki pages are stored in svn somewhere but I could not find the repo.
We could file an INFRA ticket to get a zip dump of all pages.
Looking at the Lucene wiki pages there are quite a few. Problem is most
of them are not maintained, but some are.
An alternative strategy could of course dump
Does it need to go to Confluence? I know Apache built an export tool,
but is there a way to dump the whole thing into a text archive? Or
both :-)
I am wondering if this could be a good opportunity for dog-fooding.
Load the wiki export into Solr, cross-match against RefGuide, manually
inspect the
+1
On Mon, Jun 17, 2019 at 10:18 PM Jan Høydahl 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
Great plan, Jan!
A sticky bit of this I think is how to remove old stuff. It's easy to keep
content around forever but it gets stale and clutters things up with better
content. Maybe if I/someone wants to remove content, we send out a
proposal to the list with links for easy peer review of
+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 wrote:
> Hi
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