[
https://issues.apache.org/jira/browse/SOLR-11032?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Jason Gerlowski updated SOLR-11032:
-----------------------------------
Attachment: SOLR-11032.patch
Attaching a ready-for-review patch which adds in the buildable-examples.
The attached patch moves the Java snippets out from the using-solrj page, to
build-able examples that live in {{solr/solr-ref-guide/src/java}}. These
examples can be built explicitly using the {{ant build-examples}} target in the
solr-ref-guide directory. They're also built implicitly as a part of a normal
{{ant compile}} from the project root. (And of course they're built whenever
you run {{ant build-site}} or {{ant build-pdf}} in the solr-ref-guide directory.
*PROS*
- compilation will now fail if a SolrJ API is changed without updating any
examples that use it.
- examples are compiled in builds by default. No additional ant target to
memorize, etc.
*CONS*
- the examples need Solr/SolrJ classes on their classpath to compile. And the
ref-guide build will fail if the examples don't compile. So the ref-guide
can't be built in isolation from the rest of Solr anymore. This is likely
expected, but I wanted to mention it anyways in case this was a big deal to
anyone.
This should be ready for review, if anyone has time to take a look or critique
the approach.
> Update solrj tutorial
> ---------------------
>
> Key: SOLR-11032
> URL: https://issues.apache.org/jira/browse/SOLR-11032
> Project: Solr
> Issue Type: Task
> Security Level: Public(Default Security Level. Issues are Public)
> Components: documentation, SolrJ, website
> Reporter: Karl Richter
> Attachments: SOLR-11032.patch, SOLR-11032.patch
>
>
> The [solrj tutorial](https://wiki.apache.org/solr/Solrj) has the following
> issues:
> * It refers to 1.4.0 whereas the current release is 6.x, some classes are
> deprecated or no longer exist.
> * Document-object-binding is a crucial feature [which should be working in
> the meantime](https://issues.apache.org/jira/browse/SOLR-1945) and thus
> should be covered in the tutorial.
--
This message was sent by Atlassian JIRA
(v6.4.14#64029)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
