You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by "Hoss Man (JIRA)" <ji...@apache.org> on 2013/07/16 23:52:49 UTC
[jira] [Comment Edited] (SOLR-5036) Solr Ref Guide updates for Solr
4.4
[ https://issues.apache.org/jira/browse/SOLR-5036?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13710096#comment-13710096 ]
Hoss Man edited comment on SOLR-5036 at 7/16/13 9:51 PM:
---------------------------------------------------------
I made some more progress on Cassandra's list...
* https://cwiki.apache.org/confluence/display/solr/RequestDispatcher+in+SolrConfig
** SOLR-2079 - addHttpRequestToContext verbage
* https://cwiki.apache.org/confluence/display/solr/Query+Screen
** SOLR-3838 - fq verbage and updated creenshot
** SOLR-4719 - json default verbage & updated screenshot
* https://cwiki.apache.org/confluence/display/solr/Core-Specific+Tools
** update order of links to children and actual order of children in navigation
* https://cwiki.apache.org/confluence/display/solr/IndexConfig+in+SolrConfig
** SOLR-4941, SOLR-4934 and LUCENE-5038 - already ok, page doesn't go into depth about mergePolicy, example alreayd used correct compound file syntax
* https://cwiki.apache.org/confluence/display/solr/Command+Line+Utilities
** SOLR-4972: Add PUT command to ZkCli tool
* https://cwiki.apache.org/confluence/display/solr/Other+Parsers
** SOLR-4785: MaxScoreQParser
* https://cwiki.apache.org/confluence/display/solr/Upgrading+to+Solr+4.4
** New page on upgrading to 4.4
** child of https://cwiki.apache.org/confluence/display/solr/Major+Changes+from+Solr+3+to+Solr+4
** clone of https://cwiki.apache.org/confluence/display/solr/Upgrading+to+Solr+4.3
** mention SOLR-4941, SOLR-4934 and LUCENE-5038
** mention SOLR-4778 and new LogWatcher API
----
But there is still a lot more that needs written -- stuff below i either don't understand the new feature enough to document myself, or didn't have the energy to try to tackle because it needs a lot written about it and i don't know it well enough to have a good sense of how to go about it...
* https://cwiki.apache.org/confluence/display/solr/IndexConfig+in+SolrConfig
** SOLR-4761, SOLR-4976: Add option to plugin a merged segment warmer into solrconfig.xml. Info about segments warmed in the background is available via infostream. (Mark Miller, Ryan Ernst, Mike McCandless, Robert Muir)
*** CT: Add to https://cwiki.apache.org/confluence/display/solr/IndexConfig+in+SolrConfig
* https://cwiki.apache.org/confluence/display/solr/Spell+Checking
** SOLR-3240: Add "spellcheck.collateMaxCollectDocs" option so that when testing potential Collations against the index, SpellCheckComponent will only collect n documents, thereby estimating the hit-count. This is a performance optimization in cases where exact hit-counts are unnecessary. Also, when "collateExtendedResults" is false, this optimization is always made (James Dyer).
*** CT: Add to https://cwiki.apache.org/confluence/display/solr/Spell+Checking
* https://cwiki.apache.org/confluence/display/solr/Core-Specific+Tools
** SOLR-4921: Admin UI now supports adding documents to Solr (gsingers, steffkes)
*** CT: Add a new page under https://cwiki.apache.org/confluence/display/solr/Core-Specific+Tools
** make sure child is in correct order, both in parent page links and overall nav: https://cwiki.apache.org/confluence/pages/listpages-dirview.action?key=solr
* Completley new docs about the HDFS SolrCloud support ... somewhere....
** SOLR-4916: Add support to write and read Solr index files and transaction log files to and from HDFS. (phunt, Mark Miller, Greg Chanan)
*** CT: Without studying this more, it's hard to know where this should go. It's not really SolrCloud, and it's not really a client, but depending on why it's being done it could overlap with either...If someone writes up what you'd tell someone about using it, I could give a better idea of where it fits in the existing page organization (if it does).
* https://cwiki.apache.org/confluence/display/solr/Documents%2C+Fields%2C+and+Schema+Design
** SOLR-4897: Add solr/example/example-schemaless/, an example config set for schemaless mode. (Steve Rowe)
*** CT: Schemaless in general needs to be added. The most likely place today is a new page under https://cwiki.apache.org/confluence/display/solr/Documents%2C+Fields%2C+and+Schema+Design
* https://cwiki.apache.org/confluence/display/solr/Core+Admin+and+Configuring+solr.xml
** SOLR-4757: Change the example to use the new solr.xml format and core discovery by directory structure. (Mark Miller)
*** CT: There is a page on solr.xml: https://cwiki.apache.org/confluence/display/solr/Core+Admin+and+Configuring+solr.xml. This should be updated to show the new format and still include information on the old format for anyone with the old format who uses this guide for reference.
** SOLR-4655: Add option to have Overseer assign generic node names so that new addresses can host shards without naming confusion. (Mark Miller, Anshum Gupta)
*** CT: I think this only needs to be added to any new content for solr.xml at https://cwiki.apache.org/confluence/display/solr/Core+Admin+and+Configuring+solr.xml
* https://cwiki.apache.org/confluence/display/solr/Collections+API
** SOLR-4693: A "deleteshard" collections API that unloads all replicas of a given shard and then removes it from the cluster state. It will remove only those shards which are INACTIVE or have no range (created for custom sharding). (Anshum Gupta, shalin)
*** CT: Add to https://cwiki.apache.org/confluence/display/solr/Collections+API
* https://cwiki.apache.org/confluence/display/solr/Schema+API
** SOLR-3251: Dynamically add fields to schema. (Steve Rowe, Robert Muir, yonik)
*** CT: Add to https://cwiki.apache.org/confluence/display/solr/Schema+API
** SOLR-5010: Add support for creating copy fields to the Fields REST API (gsingers)
*** CT: Add to https://cwiki.apache.org/confluence/display/solr/Schema+API
* https://cwiki.apache.org/confluence/display/solr/Detecting+Languages+During+Indexing
** SOLR-4412: New parameter langid.lcmap to map detected language code to be placed in "language" field (janhoy)
*** CT: Update https://cwiki.apache.org/confluence/display/solr/Detecting+Languages+During+Indexing
...we _REALLY_ need other folks to jump in here and help document the features they've been working on in this release.
was (Author: hossman):
I made some more progress on Cassandra's list...
* https://cwiki.apache.org/confluence/display/solr/RequestDispatcher+in+SolrConfig
** SOLR-2079 - addHttpRequestToContext verbage
* https://cwiki.apache.org/confluence/display/solr/Query+Screen
** SOLR-3838 - fq verbage and updated creenshot
** SOLR-4719 - json default verbage & updated screenshot
* https://cwiki.apache.org/confluence/display/solr/Core-Specific+Tools
** update order of links to children and actual order of children in navigation
* https://cwiki.apache.org/confluence/display/solr/IndexConfig+in+SolrConfig
** SOLR-4941, SOLR-4934 and LUCENE-5038 - already ok, page doesn't go into depth about mergePolicy, example alreayd used correct compound file syntax
* https://cwiki.apache.org/confluence/display/solr/Command+Line+Utilities
** SOLR-4972: Add PUT command to ZkCli tool
* https://cwiki.apache.org/confluence/display/solr/Other+Parsers
** SOLR-4785: MaxScoreQParser
----
But there is still a lot more that needs written -- stuff below i either don't understand the new feature enough to document myself, or didn't have the energy to try to tackle because it needs a lot written about it and i don't know it well enough to have a good sense of how to go about it...
* New page on upgrading to 4.4
** child of https://cwiki.apache.org/confluence/display/solr/Major+Changes+from+Solr+3+to+Solr+4
** clone of https://cwiki.apache.org/confluence/display/solr/Upgrading+to+Solr+4.3
** mention SOLR-4941, SOLR-4934 and LUCENE-5038
** mention SOLR-4778 and new LogWatcher API
* https://cwiki.apache.org/confluence/display/solr/IndexConfig+in+SolrConfig
** SOLR-4761, SOLR-4976: Add option to plugin a merged segment warmer into solrconfig.xml. Info about segments warmed in the background is available via infostream. (Mark Miller, Ryan Ernst, Mike McCandless, Robert Muir)
*** CT: Add to https://cwiki.apache.org/confluence/display/solr/IndexConfig+in+SolrConfig
* https://cwiki.apache.org/confluence/display/solr/Spell+Checking
** SOLR-3240: Add "spellcheck.collateMaxCollectDocs" option so that when testing potential Collations against the index, SpellCheckComponent will only collect n documents, thereby estimating the hit-count. This is a performance optimization in cases where exact hit-counts are unnecessary. Also, when "collateExtendedResults" is false, this optimization is always made (James Dyer).
*** CT: Add to https://cwiki.apache.org/confluence/display/solr/Spell+Checking
* https://cwiki.apache.org/confluence/display/solr/Core-Specific+Tools
** SOLR-4921: Admin UI now supports adding documents to Solr (gsingers, steffkes)
*** CT: Add a new page under https://cwiki.apache.org/confluence/display/solr/Core-Specific+Tools
** make sure child is in correct order, both in parent page links and overall nav: https://cwiki.apache.org/confluence/pages/listpages-dirview.action?key=solr
* Completley new docs about the HDFS SolrCloud support ... somewhere....
** SOLR-4916: Add support to write and read Solr index files and transaction log files to and from HDFS. (phunt, Mark Miller, Greg Chanan)
*** CT: Without studying this more, it's hard to know where this should go. It's not really SolrCloud, and it's not really a client, but depending on why it's being done it could overlap with either...If someone writes up what you'd tell someone about using it, I could give a better idea of where it fits in the existing page organization (if it does).
* https://cwiki.apache.org/confluence/display/solr/Documents%2C+Fields%2C+and+Schema+Design
** SOLR-4897: Add solr/example/example-schemaless/, an example config set for schemaless mode. (Steve Rowe)
*** CT: Schemaless in general needs to be added. The most likely place today is a new page under https://cwiki.apache.org/confluence/display/solr/Documents%2C+Fields%2C+and+Schema+Design
* https://cwiki.apache.org/confluence/display/solr/Core+Admin+and+Configuring+solr.xml
** SOLR-4757: Change the example to use the new solr.xml format and core discovery by directory structure. (Mark Miller)
*** CT: There is a page on solr.xml: https://cwiki.apache.org/confluence/display/solr/Core+Admin+and+Configuring+solr.xml. This should be updated to show the new format and still include information on the old format for anyone with the old format who uses this guide for reference.
** SOLR-4655: Add option to have Overseer assign generic node names so that new addresses can host shards without naming confusion. (Mark Miller, Anshum Gupta)
*** CT: I think this only needs to be added to any new content for solr.xml at https://cwiki.apache.org/confluence/display/solr/Core+Admin+and+Configuring+solr.xml
* https://cwiki.apache.org/confluence/display/solr/Collections+API
** SOLR-4693: A "deleteshard" collections API that unloads all replicas of a given shard and then removes it from the cluster state. It will remove only those shards which are INACTIVE or have no range (created for custom sharding). (Anshum Gupta, shalin)
*** CT: Add to https://cwiki.apache.org/confluence/display/solr/Collections+API
* https://cwiki.apache.org/confluence/display/solr/Schema+API
** SOLR-3251: Dynamically add fields to schema. (Steve Rowe, Robert Muir, yonik)
*** CT: Add to https://cwiki.apache.org/confluence/display/solr/Schema+API
** SOLR-5010: Add support for creating copy fields to the Fields REST API (gsingers)
*** CT: Add to https://cwiki.apache.org/confluence/display/solr/Schema+API
* https://cwiki.apache.org/confluence/display/solr/Detecting+Languages+During+Indexing
** SOLR-4412: New parameter langid.lcmap to map detected language code to be placed in "language" field (janhoy)
*** CT: Update https://cwiki.apache.org/confluence/display/solr/Detecting+Languages+During+Indexing
...we _REALLY_ need other folks to jump in here and help document the features they've been working on in this release.
> Solr Ref Guide updates for Solr 4.4
> -----------------------------------
>
> Key: SOLR-5036
> URL: https://issues.apache.org/jira/browse/SOLR-5036
> Project: Solr
> Issue Type: Improvement
> Components: documentation
> Reporter: Cassandra Targett
> Fix For: 4.4
>
>
> In response to Hoss' email about updating the Solr Ref Guide, I thought it would be helpful if I went through the CHANGES.txt file and noted what I think might need an update (or a new page) and what pages should be reviewed for each change. I hope this helps those who aren't yet fully versed with the way it's organized.
> I commented on every item in CHANGES.txt, so I'll post my suggestions in a couple of comments. Many items (like bug fixes) don't really need updates, but more eyes on that would be helpful.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org