[
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
The one/only advantage of having the examples live in
{{solr/solr-ref-guide/src/java}} is that any attempt to build pages of the ref
guide outside of ant will look for included files in descendants of
{{solr/solr-ref-guide/src}}. The main time this comes up is if you're using an
editor that supports live-preview of your asciidoc pages.
That said, it's possible to avoid breaking these sort of live-preview cases by
having an ant task copy the examples to expected place. I've taken this
approach in the attached patch. The examples live in a package under
{{solr/solrj/src/test}}. They can be copied to
{{solr/solr-ref-guide/src/example}} by the ref-guide target: {{ant
copy-examples]}. This gets us all of the advantages that Hoss pointed out,
while at least providing a work around for people who like their live-preview.
> 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, 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]
