Mailing-List: contact commits-help@lucene.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@lucene.apache.org
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
From: Apache Wiki <wikidiffs@apache.org>
To: Apache Wiki <wikidiffs@apache.org>
Date: Tue, 20 Dec 2016 22:00:19 -0000
Message-ID: <148227121949.3379.5466699330462111755@moin-vm.apache.org>
Subject: =?utf-8?q?=5BSolr_Wiki=5D_Update_of_=22WikiManualComparison=22_by_Cassand?=
 =?utf-8?q?raTargett?=
Auto-Submitted: auto-generated
archived-at: Tue, 20 Dec 2016 22:01:12 -0000

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Solr Wiki" for chan=
ge notification.

The "WikiManualComparison" page has been changed by CassandraTargett:
https://wiki.apache.org/solr/WikiManualComparison?action=3Ddiff&rev1=3D16&r=
ev2=3D17

  Wiki: [[CollapsingQParserPlugin]] (2014-02-19) <<BR>> =

  Manual: [[https://cwiki.apache.org/confluence/display/solr/Collapse+and+E=
xpand+Results|Collapse and Expand Results]] <<BR>>
  =

- Page migration header added 2016-08-15.
+ '''Page migration header added 2016-08-15.'''
    =

  =3D=3D CollectionDistribution =3D=3D
  Wiki: [[CollectionDistribution]] (2012-09-24) <<BR>>
@@ -104, +104 @@

  Wiki: [[CommitWithin]] (2012-06-22) <<BR>>
  Manual: [[https://cwiki.apache.org/confluence/display/solr/UpdateHandlers=
+in+SolrConfig|UpdateHandlers in SolrConfig]] (2014-12-12) <<BR>>
  =

+ '''Page migration header added 2016-12-20'''
-  * CommitWithin has its own page in the Wiki, but is found in a section o=
f the above manual page in the Solr Manual. The wiki discusses numerous way=
s to convey commitWithin information to Solr, and contails a Java example f=
or the purpse of using it with SolrJ:
-  =

- {{{#!java
- UpdateRequest req =3D new UpdateRequest();
-     req.add(mySolrInputDocument);
-     req.setCommitWithin(10000);
-     req.process(server);
- }}}
- =

-  * The Manual indicates that a soft commit is the default in the schema, =
and illustrates how to enact a hard commit in xml:
- =

- {{{#!xml
- <commitWithin>
-   <softCommit>false</softCommit>
- </commitWithin>
- }}}
- =

-  * The manual emphasizes [[https://cwiki.apache.org/confluence/display/so=
lr/Near+Real+Time+Searching|Near Real Time Searching (NRT)]], which is not =
mentioned on the the Wiki page. =

  =

  =3D=3D CommonQueryParameters =3D=3D
  Wiki: [[CommonQueryParameters]] (2014-04-03] <<BR>>
@@ -140, +123 @@

  Wiki: [[ComplexFacetingBrainstorming]] (2009-09-20) <<BR>>
  Manual: N/A <<BR>>
  =

- As the name indicates, this page was intended for use as a brainstorming =
platform about complex faceting, and it has no manual equivalent.
+ Does not need to be migrated (CCT 2016-12-20)
  =

  =3D=3D ComplexPhraseQueryParser =3D=3D
  Wiki: [[ComplexPhraseQueryParser]] (2014-08-31) <<BR>>
  Manual: [[https://cwiki.apache.org/confluence/display/solr/Other+Parsers#=
OtherParsers-ComplexPhraseQueryParser|Other Paersers]](2014-10-29) <<BR>>
  =

-  * The wiki page contains an alert at the top of the page informing users=
 that the page is outdated and that they should refer to the above manual p=
age instead.   It is more feasible in this scenario to simply port over the=
 manual page than to observe the extensive list of differences between the =
two, which includes completely different syntax in most of the code example=
s, and numerous references to procedures in the manual that are not present=
 in the Wiki.
-  =

+ '''Page migration header added 2016-12-20'''
+ =

  =3D=3D ConfiguringSolr =3D=3D
  Wiki: [[ConfiguringSolr]] (2013-05-21) <<BR>>
  Manual: [[ https://cwiki.apache.org/confluence/display/solr/The+Well-Conf=
igured+Solr+Instance|The Well-Configured Solr Instance]] (2014-12-10) <<BR>>
@@ -158, +141 @@

  Wiki: [[ContentStream]] (2011-03-11) <<BR>>
  Manual: [[https://cwiki.apache.org/confluence/display/solr/Content+Stream=
s|Content Stream]] (2014-12-12)<<BR>>
  =

+ '''Page migration header added 2016-12-20'''
-  * The code example in the wiki under '''RemoteStreaming''' contains an a=
dditional line: ''multipartUploadLimitInKB=3D"2048"'', which is not found i=
n the manual.
-  * The manual contains an alert, which may be necessary to add to the wik=
i: =

-     ''If you enableRemoteStreaming=3D"true" is used, be aware that this a=
llows anyone to send a request to any URL or local file. If DumpRequestHand=
ler  is enabled, it will allow anyone to view any file on your system.''
      =

  =3D=3D ContentStreamUpdateRequestExample =3D=3D
  Wiki: [[ContentStreamUpdateRequestExample]] (2010-05-28) <<BR>>
@@ -172, +153 @@

  Wiki: Redirects to [[Core Discovery (4.4 and beyond)]] (2014-09-11)<<BR>>
  Manual: [[https://cwiki.apache.org/confluence/display/solr/Solr+Cores+and=
+solr.xml|Solr Cores and solr.xml]](2013-07-23)<<BR>>
  =

- See next section.
+ Does not need to be migrated (CCT 2016-12-20)
  =

  =3D=3D Core Discovery (4.4 and Beyond) =3D=3D
  Wiki: [[Core Discovery (4.4 and beyond)]] (2014-09-11)<<BR>>
  Manual: [https://cwiki.apache.org/confluence/display/solr/Solr+Cores+and+=
solr.xml|Solr Cores and solr.xml]](2013-07-23)<<BR>>
  =

-  * Documentation for Core Discovery appears to be a work-in-progress in t=
he wiki, where the initial portions of the page recommends using ''solr.xml=
'' to manually enable dynamic core administation, a process that is being p=
hased out as a matter of distinction between the legacy and discovery modes=
 (the latter of which is to become mandatory in 5.0).
+ Does note need to be migrated (CCT 2016-12-20)
+ =

  <<Anchor(CoreAdmin)>> =

  =3D=3D CoreAdmin =3D=3D
  Wiki: [[CoreAdmin]] (2013-08-29) <<BR>>
@@ -198, +180 @@

  Wiki: [[CSVResponseWriter]] (2011-09-19) <<BR>>
  Manual: [[https://cwiki.apache.org/confluence/display/solr/Response+Write=
rs#ResponseWriters-CSVResponseWriter]] (2014-02-27) <<BR>>
  =

- There is no notable difference between the wiki page and the manual's equ=
ivalent section.
+ '''Page migration header added 2016-12-20'''
  =

  =3D=3D CSVUpdateRequestHandler =3D=3D
  Wiki: [[UpdateCSV]] (2014-03-13) <<BR>>
  Manual: [[https://cwiki.apache.org/confluence/display/solr/Response+Write=
rs#ResponseWriters-CSVResponseWriter]] (2014-02-27) <<BR>>
  =

- The CSVUpdateRequestHandler is not mentioned in the manual, though the ph=
rase "....compatible with the CSV update format" which links back to the wi=
ki page.
+ '''Page migration header added 2016-12-20'''
+ =

  <<Anchor(CurrencyField)>>
  =3D=3D CurrencyField =3D=3D
  Wiki: [[CurrencyField]] (2013-06-02) <<BR>>
  Manual: [[https://cwiki.apache.org/confluence/display/solr/Working+with+C=
urrencies+and+Exchange+Rates|Working With Currencies and Exchange Rates]] (=
2014-02-27) <<BR>>
  =

-  * In the code snippet for '''configuration''' the wiki contains the line=
 ''<dynamicField name=3D"*_c" type=3D"currency" />'' at the beginning, whic=
h is not found in the manual's code snippet.  This isn't necessarily extran=
eous, but the concept of dynamic fields is a separate entity than that of c=
urrency configuration, and may need to be omitted to avoid confuction.
+ '''Page migration header added 2016-12-20'''
  =

  [[#Return to Top|Return to Top]]
  =3D=3D DaemonTools =3D=3D
@@ -249, +232 @@

  Wiki: [[DeploymentofSolrCoreswithZookeeper]] (2010-03-01) <<BR>>
  Manual: [[https://cwiki.apache.org/confluence/display/solr/Nodes%2C+Cores=
%2C+Clusters+and+Leaders|Nodes, Cores, Clusters and Leaders]] (2014-12-18) =
<<BR>>
  =

+ Made note that this page refers to SOLR-1724 and not SolrCloud (CCT 2016-=
12-20)
-  * Compared to the manual, the wiki page is incomplete.  Specifically, th=
e manual contains detailed explainations regarding '''clusters''' and their=
 use with ''SolrCloud'', but there is only a single mention of clusters und=
er the TODO section of the wiki page, and the Solr Cloud is mentioned only =
to provide an external link.
-  * The wiki page references a ''CoreContainer'', which isn't found anywhe=
re in the manual, and links to a page that does not exist in the wiki.
-  * The only actual similarities between the two pages is that they both m=
ention Zookeeper (the only page in both the manual and the wiki where this =
is extensively referenced), and both mention cores, but they are otherwise =
completely different.  The manual appears to be focused on Zookeeper's impl=
ementation with SolrCloud, where the wiki is more a conceptual overview of =
how Zookeeper works with Solr nodes.
   =

  =3D=3D DIHCustomFunctions =3D=3D
  Wiki: [[DIHCustomFunctions]] (2011-07-11)<<BR>>