lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Karl Richter (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (SOLR-11032) Update solrj tutorial
Date Fri, 07 Jul 2017 10:24:01 GMT

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

Karl Richter commented on SOLR-11032:
-------------------------------------

> And we should probably move it to the ref-guide too. Or would the SolrJ tutorial work
better as a GitHub repo with multiple examples that you could run, study, modify, copy/paste?

Can't it be both? Maintaining documentation resources outside the code is painful (and maybe
therefore didn't happen for 5 years in this afaik), so it should be easy to contribute and
there's no easier way than PRs. However, if it's a plain project that one has to build with
tools with different installation routines on different OS (which is what a GitHub tutorial
is in my understanding), then maintenance need and user frustration might increase. Consequently,
an automatically built and updated version in form of HTML should be provided in the ref-guide
and the maintenance occur on GitHub.

> 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: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


Mime
View raw message