[ 
https://issues.apache.org/jira/browse/SOLR-11032?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16080921#comment-16080921
 ] 

Cassandra Targett commented on SOLR-11032:
------------------------------------------

bq. Can't it be both?

Yes, it could be both.

If you decide to make a 2nd github repo, and you write your README and any 
other docs in AsciiDoc format, it would be easily possible to pull sections of 
it into the Ref Guide as intro or basic materials, and point users to the repo 
for more details. We could even pull in snippets of example code as necessary 
(and annotate it).

Or, instead of a separate repo, maybe we should find a way to add the examples 
to Solr's source itself? Then they can be tested and updated as changes occur 
in Solr.

Either way, I've long wished someone would beef up the Solr Ref Guide's SolrJ 
coverage - whether it's in Solr's repo or another one, I hope some progress can 
be made.

> 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
>
> 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]

Reply via email to