You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@lucene.apache.org by Chris Hostetter <ho...@fucit.org> on 2015/02/12 23:42:04 UTC
VOTE: RC0 Release apache-solr-ref-guide-5.0.pdf
Please vote to release the following artifact as the "Apache Solr
Reference Guide for Solr 5.0" ...
https://dist.apache.org/repos/dist/dev/lucene/solr/ref-guide/apache-solr-ref-guide-5.0-RC0/
-Hoss
http://www.lucidworks.com/
Re: VOTE: RC0 Release apache-solr-ref-guide-5.0.pdf
Posted by Tomás Fernández Löbbe <to...@gmail.com>.
In suggesters, it says that the field needs to be indexed, but really it
needs to be stored. I'll change that.
I would also like to warn users that when using "buildOnCommit" or
"buildOnOptimize", the suggester build may take a long time, making the
commit itself take too long. This definitely doesn't play along very well
with an autoSoftCommit of a couple of seconds.
On Fri, Feb 13, 2015 at 10:24 AM, Chris Hostetter <ho...@fucit.org>
wrote:
>
> : Yes, I think it might make sense to wait and respin around the same time
> as
> : the next Lucene/Solr RC.
>
> I should have clarified when i initially sent out hte RC...
>
> All ASF Votes are open for a minimum of 72 Hours, but it is my intention
> not to call this RC (or any future RC) 5.0 ref-guide vote to a close until
> after the 5.0 *code* release is finalized & pushed to the dist repo
> mirrors in case there are lsat minute doc notes that need to be included.
>
>
> As folks are finding mistakes in the RC, feel free to edit -- i'm happy to
> generated an RC1 later tonight.
>
>
>
>
> -Hoss
> http://www.lucidworks.com/
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: dev-help@lucene.apache.org
>
>
Re: VOTE: RC0 Release apache-solr-ref-guide-5.0.pdf
Posted by Chris Hostetter <ho...@fucit.org>.
: Yes, I think it might make sense to wait and respin around the same time as
: the next Lucene/Solr RC.
I should have clarified when i initially sent out hte RC...
All ASF Votes are open for a minimum of 72 Hours, but it is my intention
not to call this RC (or any future RC) 5.0 ref-guide vote to a close until
after the 5.0 *code* release is finalized & pushed to the dist repo
mirrors in case there are lsat minute doc notes that need to be included.
As folks are finding mistakes in the RC, feel free to edit -- i'm happy to
generated an RC1 later tonight.
-Hoss
http://www.lucidworks.com/
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org
Re: VOTE: RC0 Release apache-solr-ref-guide-5.0.pdf
Posted by Anshum Gupta <an...@anshumgupta.net>.
Yes, I think it might make sense to wait and respin around the same time as
the next Lucene/Solr RC.
On Fri, Feb 13, 2015 at 10:07 AM, Cassandra Targett <ca...@gmail.com>
wrote:
> I've also found a number of issues, and have been fixing the most
> egregious ones as I review the PDF & keeping a list of smaller TODOs for
> later. I'm mostly fixing the evil span tags as I find them but other issues
> with strange line spaces also.
>
> Since Steve has found some big issues to fix, we should respin - I'm only
> halfway through my review today, but should be done by this afternoon.
>
> - Cassandra
>
> On Fri, Feb 13, 2015 at 10:42 AM, Steve Rowe <sa...@gmail.com> wrote:
>
>>
>> > On Feb 12, 2015, at 5:42 PM, Chris Hostetter <ho...@fucit.org>
>> wrote:
>> >
>> >
>> > Please vote to release the following artifact as the "Apache Solr
>> Reference Guide for Solr 5.0" ...
>> >
>> >
>> https://dist.apache.org/repos/dist/dev/lucene/solr/ref-guide/apache-solr-ref-guide-5.0-RC0/
>>
>> I found several mentions of deprecated features to be removed in 5.0
>> (which have actually been removed).
>>
>> I think this is worthy of respin.
>>
>> Details about these as well as other more minor issues (evil span tags
>> causing larger-than-normal font size, etc.) below.
>>
>> I’ll start fixing shortly.
>>
>> Steve
>> http://www.lucidworks.com
>>
>> ——
>> Getting Started:
>> Large font: After /When getting started, all you need to do is/:
>> extract the Solr (and further on)
>>
>> Running Solr:
>> Large font: "This will create a core that uses a data-driven schema
>> which
>> tries to guess the correct field type when you add documents to
>> the index.
>> To see all available options for creating a new core, execute:"
>> bin/post <- should be monospace
>> Large font: "Go ahead and add all the documents in some JSON files:"
>>
>> Solr Start Script Reference
>> -a "<string>" example: -Xrunjdwp:tr… <- this is truncated - should be
>> manually wrapped
>>
>> Solr Field Types
>> Field types included with Solr
>> Many types are to be removed in 5.0... these should be gone
>> Dynamic Fields
>> Dynamic fields are also defined in the fields element of
>> schema.xml. <- fields element is optional
>>
>> Filter descriptions
>> PositionFilterFactory:This filter has been deprecated and will be
>> removed in Solr 5.
>> SuggestStopFilter
>> Large font: words: (optional...
>> Large font: wordset: This is the...
>> Synonym Filter (this heading is larger than it should be)
>> Large font: format: The short names...
>>
>> Char Filter Factories
>> Large font: solr.MappingCharFilterFactory
>> solr.HTMLStripCharFilterFactory
>> Large font: “org.apache.solr.analysis.HTMLStripCharFilter"...
>>
>> Language Analysis
>> CollationKeyFilterFactory and ICUCollationKeyFilterFactory are
>> deprecated token filter
>> implementations of the same functionality as solr.CollationField
>> and solr.ICUCollationField,
>>
>> Large font: Factory class: solr.ScandinavianNormalizationFilterFactory
>> Large font: Factory class: solr.ScandinavianFoldingFilterFactory
>>
>> Uploading Data with Index Handlers
>> Comments are not allowed in JSON, but duplicate names are. <- Noggit
>> 0.6 supports comments
>> The comments in the above example are for illustrative purposes only,
>> and can not be included in actual commands sent to Solr.
>>
>> Missing close parens: "In this example, we simply named the field
>> paths (such as /exams/test." <-
>>
>> Uploading Data with Solr Cell using Apache Tika
>> See http://tika.apche.org/1.5/formats.html <- wrong Tika version
>> Input parameters
>> xpath: See http://tika.apache.org/1.5/index.html <- wrong Tika
>> version
>>
>> Uploading Structured Data Store Data with the Data Import Handler
>> Data Import Handler Commands
>> delta-import <- should be monospace
>>
>> Query Syntax and Parsing
>> Common Query Parameters
>> fl: With version 3.6, Solr limited the query's responses to a
>> listed set of fields.
>> With version 4.0, this parameter returns only the score. <-
>> WTF???
>> logParamsList: By default, Solr logs all parameters. From
>> version 4.7 <- not a historical document
>>
>> Spell Checking
>> Warning box
>> "If you are still using the SpellCheckComponent-based approach, we
>> recommend
>> changing to the SuggestComponent instead. However, the below
>> snippet from
>> solrconfig.xml that shows how to configure s olrconfig.xml to use
>> the
>> SpellCheckComponent.” <- “that” is extraneous and breaks the 2nd
>> sentence.
>> (fixed already)
>>
>> Query Re-Ranking
>> Result Paging With Query Re-Ranking
>> Too much vertical blank space around code boxes
>>
>> Suggester
>> 'solr -e techproducts -a “-Dsolr.suggester.enabled=true”’ <- the ‘-a’
>> is no longer necessary
>>
>> Collapse and Expand Results
>> Too much vertical blank space above “The CollapsingQParserPlugin
>> fully supports the QueryElevationComponent.”
>>
>>
>> Configuring solrconfig.xml
>> Managed Schema Definition in SolrConfig
>> Should not be monospace: 'By default, if no schemaFactory is
>> specified, then
>> the default behavior is to use the
>> "ClassicIndexSchemaFactory" as in this example
>> from the sample_techproducts_configs config set:'
>>
>> CoreAdmin API
>> SPLIT
>> Large font: "Here the core index will be split into two pieces…”
>>
>> Configuring Logging
>> Both screenshot have the old Solr logo.
>> Large font: "By default, Solr log messages will be written to
>> server/logs/solr.log…”
>> Large font: "While you’re customizing the log4j.properties file, we
>> also recommend…”
>>
>> Running Solr on HDFS
>> Kerberos Authentication Settings
>> Description is grayed out for
>> solr.hdfs.security.kerberos.keytabfile
>>
>> Configuring statsCache implementation
>> Large font: "ExactStatsCache: This implementation uses global values
>> for…"
>>
>> ZooKeeper ensemble
>> Using ZooKeeper to Manage Configuration Files
>> Large font: "The create command will upload a copy of the
>> data_driven_schema_configs…”
>> Startup Bootstrap
>> Too much vertical blank space after code box “$ bin/solr -e
>> cloud -noprompt”
>>
>> Collections API
>> API Entry Points
>> Create a Collection
>> The link includes unnecessary spaces, mostly around
>> italicized parts
>> Delete Replica Property
>> Link should have italicized template values but doesn’t
>> Balance a property, one per shard, evenly across a collection’s
>> nodes
>> Link should be monospace, with italicized template values
>> Large font: Asynchronous Calls
>> Parameter Reference
>> SolrCloud Instance Parameters
>> grayed-out text in description of hostPort
>>
>> Major Changes from Solr 4 to Solr 5
>> Extra vertical space at the bottom of the page
>>
>>
>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
>> For additional commands, e-mail: dev-help@lucene.apache.org
>>
>>
>
--
Anshum Gupta
http://about.me/anshumgupta
Re: VOTE: RC0 Release apache-solr-ref-guide-5.0.pdf
Posted by Cassandra Targett <ca...@gmail.com>.
I've also found a number of issues, and have been fixing the most egregious
ones as I review the PDF & keeping a list of smaller TODOs for later. I'm
mostly fixing the evil span tags as I find them but other issues with
strange line spaces also.
Since Steve has found some big issues to fix, we should respin - I'm only
halfway through my review today, but should be done by this afternoon.
- Cassandra
On Fri, Feb 13, 2015 at 10:42 AM, Steve Rowe <sa...@gmail.com> wrote:
>
> > On Feb 12, 2015, at 5:42 PM, Chris Hostetter <ho...@fucit.org>
> wrote:
> >
> >
> > Please vote to release the following artifact as the "Apache Solr
> Reference Guide for Solr 5.0" ...
> >
> >
> https://dist.apache.org/repos/dist/dev/lucene/solr/ref-guide/apache-solr-ref-guide-5.0-RC0/
>
> I found several mentions of deprecated features to be removed in 5.0
> (which have actually been removed).
>
> I think this is worthy of respin.
>
> Details about these as well as other more minor issues (evil span tags
> causing larger-than-normal font size, etc.) below.
>
> I’ll start fixing shortly.
>
> Steve
> http://www.lucidworks.com
>
> ——
> Getting Started:
> Large font: After /When getting started, all you need to do is/:
> extract the Solr (and further on)
>
> Running Solr:
> Large font: "This will create a core that uses a data-driven schema
> which
> tries to guess the correct field type when you add documents to
> the index.
> To see all available options for creating a new core, execute:"
> bin/post <- should be monospace
> Large font: "Go ahead and add all the documents in some JSON files:"
>
> Solr Start Script Reference
> -a "<string>" example: -Xrunjdwp:tr… <- this is truncated - should be
> manually wrapped
>
> Solr Field Types
> Field types included with Solr
> Many types are to be removed in 5.0... these should be gone
> Dynamic Fields
> Dynamic fields are also defined in the fields element of
> schema.xml. <- fields element is optional
>
> Filter descriptions
> PositionFilterFactory:This filter has been deprecated and will be
> removed in Solr 5.
> SuggestStopFilter
> Large font: words: (optional...
> Large font: wordset: This is the...
> Synonym Filter (this heading is larger than it should be)
> Large font: format: The short names...
>
> Char Filter Factories
> Large font: solr.MappingCharFilterFactory
> solr.HTMLStripCharFilterFactory
> Large font: “org.apache.solr.analysis.HTMLStripCharFilter"...
>
> Language Analysis
> CollationKeyFilterFactory and ICUCollationKeyFilterFactory are
> deprecated token filter
> implementations of the same functionality as solr.CollationField
> and solr.ICUCollationField,
>
> Large font: Factory class: solr.ScandinavianNormalizationFilterFactory
> Large font: Factory class: solr.ScandinavianFoldingFilterFactory
>
> Uploading Data with Index Handlers
> Comments are not allowed in JSON, but duplicate names are. <- Noggit
> 0.6 supports comments
> The comments in the above example are for illustrative purposes only,
> and can not be included in actual commands sent to Solr.
>
> Missing close parens: "In this example, we simply named the field
> paths (such as /exams/test." <-
>
> Uploading Data with Solr Cell using Apache Tika
> See http://tika.apche.org/1.5/formats.html <- wrong Tika version
> Input parameters
> xpath: See http://tika.apache.org/1.5/index.html <- wrong Tika
> version
>
> Uploading Structured Data Store Data with the Data Import Handler
> Data Import Handler Commands
> delta-import <- should be monospace
>
> Query Syntax and Parsing
> Common Query Parameters
> fl: With version 3.6, Solr limited the query's responses to a
> listed set of fields.
> With version 4.0, this parameter returns only the score. <-
> WTF???
> logParamsList: By default, Solr logs all parameters. From version
> 4.7 <- not a historical document
>
> Spell Checking
> Warning box
> "If you are still using the SpellCheckComponent-based approach, we
> recommend
> changing to the SuggestComponent instead. However, the below
> snippet from
> solrconfig.xml that shows how to configure s olrconfig.xml to use
> the
> SpellCheckComponent.” <- “that” is extraneous and breaks the 2nd
> sentence.
> (fixed already)
>
> Query Re-Ranking
> Result Paging With Query Re-Ranking
> Too much vertical blank space around code boxes
>
> Suggester
> 'solr -e techproducts -a “-Dsolr.suggester.enabled=true”’ <- the ‘-a’
> is no longer necessary
>
> Collapse and Expand Results
> Too much vertical blank space above “The CollapsingQParserPlugin fully
> supports the QueryElevationComponent.”
>
>
> Configuring solrconfig.xml
> Managed Schema Definition in SolrConfig
> Should not be monospace: 'By default, if no schemaFactory is
> specified, then
> the default behavior is to use the "ClassicIndexSchemaFactory"
> as in this example
> from the sample_techproducts_configs config set:'
>
> CoreAdmin API
> SPLIT
> Large font: "Here the core index will be split into two pieces…”
>
> Configuring Logging
> Both screenshot have the old Solr logo.
> Large font: "By default, Solr log messages will be written to
> server/logs/solr.log…”
> Large font: "While you’re customizing the log4j.properties file, we
> also recommend…”
>
> Running Solr on HDFS
> Kerberos Authentication Settings
> Description is grayed out for
> solr.hdfs.security.kerberos.keytabfile
>
> Configuring statsCache implementation
> Large font: "ExactStatsCache: This implementation uses global values
> for…"
>
> ZooKeeper ensemble
> Using ZooKeeper to Manage Configuration Files
> Large font: "The create command will upload a copy of the
> data_driven_schema_configs…”
> Startup Bootstrap
> Too much vertical blank space after code box “$ bin/solr -e
> cloud -noprompt”
>
> Collections API
> API Entry Points
> Create a Collection
> The link includes unnecessary spaces, mostly around italicized
> parts
> Delete Replica Property
> Link should have italicized template values but doesn’t
> Balance a property, one per shard, evenly across a collection’s
> nodes
> Link should be monospace, with italicized template values
> Large font: Asynchronous Calls
> Parameter Reference
> SolrCloud Instance Parameters
> grayed-out text in description of hostPort
>
> Major Changes from Solr 4 to Solr 5
> Extra vertical space at the bottom of the page
>
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: dev-help@lucene.apache.org
>
>
Re: VOTE: RC0 Release apache-solr-ref-guide-5.0.pdf
Posted by Steve Rowe <sa...@gmail.com>.
> On Feb 12, 2015, at 5:42 PM, Chris Hostetter <ho...@fucit.org> wrote:
>
>
> Please vote to release the following artifact as the "Apache Solr Reference Guide for Solr 5.0" ...
>
> https://dist.apache.org/repos/dist/dev/lucene/solr/ref-guide/apache-solr-ref-guide-5.0-RC0/
I found several mentions of deprecated features to be removed in 5.0 (which have actually been removed).
I think this is worthy of respin.
Details about these as well as other more minor issues (evil span tags causing larger-than-normal font size, etc.) below.
I’ll start fixing shortly.
Steve
http://www.lucidworks.com
——
Getting Started:
Large font: After /When getting started, all you need to do is/:
extract the Solr (and further on)
Running Solr:
Large font: "This will create a core that uses a data-driven schema which
tries to guess the correct field type when you add documents to the index.
To see all available options for creating a new core, execute:"
bin/post <- should be monospace
Large font: "Go ahead and add all the documents in some JSON files:"
Solr Start Script Reference
-a "<string>" example: -Xrunjdwp:tr… <- this is truncated - should be manually wrapped
Solr Field Types
Field types included with Solr
Many types are to be removed in 5.0... these should be gone
Dynamic Fields
Dynamic fields are also defined in the fields element of schema.xml. <- fields element is optional
Filter descriptions
PositionFilterFactory:This filter has been deprecated and will be removed in Solr 5.
SuggestStopFilter
Large font: words: (optional...
Large font: wordset: This is the...
Synonym Filter (this heading is larger than it should be)
Large font: format: The short names...
Char Filter Factories
Large font: solr.MappingCharFilterFactory
solr.HTMLStripCharFilterFactory
Large font: “org.apache.solr.analysis.HTMLStripCharFilter"...
Language Analysis
CollationKeyFilterFactory and ICUCollationKeyFilterFactory are deprecated token filter
implementations of the same functionality as solr.CollationField and solr.ICUCollationField,
Large font: Factory class: solr.ScandinavianNormalizationFilterFactory
Large font: Factory class: solr.ScandinavianFoldingFilterFactory
Uploading Data with Index Handlers
Comments are not allowed in JSON, but duplicate names are. <- Noggit 0.6 supports comments
The comments in the above example are for illustrative purposes only,
and can not be included in actual commands sent to Solr.
Missing close parens: "In this example, we simply named the field paths (such as /exams/test." <-
Uploading Data with Solr Cell using Apache Tika
See http://tika.apche.org/1.5/formats.html <- wrong Tika version
Input parameters
xpath: See http://tika.apache.org/1.5/index.html <- wrong Tika version
Uploading Structured Data Store Data with the Data Import Handler
Data Import Handler Commands
delta-import <- should be monospace
Query Syntax and Parsing
Common Query Parameters
fl: With version 3.6, Solr limited the query's responses to a listed set of fields.
With version 4.0, this parameter returns only the score. <- WTF???
logParamsList: By default, Solr logs all parameters. From version 4.7 <- not a historical document
Spell Checking
Warning box
"If you are still using the SpellCheckComponent-based approach, we recommend
changing to the SuggestComponent instead. However, the below snippet from
solrconfig.xml that shows how to configure s olrconfig.xml to use the
SpellCheckComponent.” <- “that” is extraneous and breaks the 2nd sentence.
(fixed already)
Query Re-Ranking
Result Paging With Query Re-Ranking
Too much vertical blank space around code boxes
Suggester
'solr -e techproducts -a “-Dsolr.suggester.enabled=true”’ <- the ‘-a’ is no longer necessary
Collapse and Expand Results
Too much vertical blank space above “The CollapsingQParserPlugin fully supports the QueryElevationComponent.”
Configuring solrconfig.xml
Managed Schema Definition in SolrConfig
Should not be monospace: 'By default, if no schemaFactory is specified, then
the default behavior is to use the "ClassicIndexSchemaFactory" as in this example
from the sample_techproducts_configs config set:'
CoreAdmin API
SPLIT
Large font: "Here the core index will be split into two pieces…”
Configuring Logging
Both screenshot have the old Solr logo.
Large font: "By default, Solr log messages will be written to server/logs/solr.log…”
Large font: "While you’re customizing the log4j.properties file, we also recommend…”
Running Solr on HDFS
Kerberos Authentication Settings
Description is grayed out for solr.hdfs.security.kerberos.keytabfile
Configuring statsCache implementation
Large font: "ExactStatsCache: This implementation uses global values for…"
ZooKeeper ensemble
Using ZooKeeper to Manage Configuration Files
Large font: "The create command will upload a copy of the data_driven_schema_configs…”
Startup Bootstrap
Too much vertical blank space after code box “$ bin/solr -e cloud -noprompt”
Collections API
API Entry Points
Create a Collection
The link includes unnecessary spaces, mostly around italicized parts
Delete Replica Property
Link should have italicized template values but doesn’t
Balance a property, one per shard, evenly across a collection’s nodes
Link should be monospace, with italicized template values
Large font: Asynchronous Calls
Parameter Reference
SolrCloud Instance Parameters
grayed-out text in description of hostPort
Major Changes from Solr 4 to Solr 5
Extra vertical space at the bottom of the page
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org
Re: VOTE: RC0 Release apache-solr-ref-guide-5.0.pdf
Posted by Jan Høydahl <ja...@cominvent.com>.
A few comments:
Getting started/Installing Solr:
* Strange language in first paragraph "You can install Solr anywhere that a suitable Java Runtime Environment (JRE) is available..."
* This sentence can be removed now that SOLR-6693 is fixed: "On Windows, we recommend extracting Solr to a directory that does not contain spaces, such as C:\Apps."
Running Solr:
* This sentence "If you are running Windows, you can start the Web server by running..." -- solr is not a web server
* No need to spell out "C:\Applications\Solr\bin\solr.cmd start" when "bin\solr.cmd start" is sufficient (Windows will even resolve solr to solr.cmd)
All of these are minor, no respin needed
--
Jan Høydahl, search solution architect
Cominvent AS - www.cominvent.com
> 12. feb. 2015 kl. 23.42 skrev Chris Hostetter <ho...@fucit.org>:
>
>
> Please vote to release the following artifact as the "Apache Solr Reference Guide for Solr 5.0" ...
>
> https://dist.apache.org/repos/dist/dev/lucene/solr/ref-guide/apache-solr-ref-guide-5.0-RC0/
>
>
>
> -Hoss
> http://www.lucidworks.com/
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: dev-help@lucene.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org