chatman commented on code in PR #1130:
URL: https://github.com/apache/solr/pull/1130#discussion_r1008578302


##########
solr/solr-ref-guide/modules/getting-started/pages/introduction.adoc:
##########
@@ -16,28 +16,32 @@
 // specific language governing permissions and limitations
 // under the License.
 
-Solr is a search server built on top of https://lucene.apache.org[Apache 
Lucene], an open source, Java-based, information retrieval library.
-It is designed to drive powerful document retrieval applications - wherever 
you need to serve data to users based on their queries, Solr can work for you.
+Apache^TM^ Solr is a search server built on top of 
https://lucene.apache.org[Apache Lucene^TM^], an open source, Java-based, 
information retrieval library.
+Solr is designed to drive powerful document retrieval or analytical 
applications involving unstructured data, semi-structured data or a mix of 
unstructured and structured data.
+It also has secondary support for limited relational, graph, statistical, data 
analysis or storage related use cases.
+Since Solr is Apache 2.0 licensed open source software designed for 
extensibility, it gives you the freedom to adapt or optimize it for almost any 
commercial or non-commercial use case.
 
-Solr is based on open standards and it is highly extensible.
-Solr queries are simple HTTP request URLs and the response is a structured 
document: mainly JSON, but it could also be XML, CSV, or other formats.
-This means that a wide variety of clients will be able to use Solr, from other 
web applications to browser clients, rich client applications, and mobile 
devices.
-Any platform capable of HTTP can talk to Solr.
-See xref:deployment-guide:client-apis.adoc[] for details on client APIs.
+Solr's xref:query-guide:query-syntax-and-parsers.adoc[query syntax and 
parsers] offer support for everything from the simplest keyword searching 
through to complex queries on multiple fields and 
xref:query-guide:faceting.adoc[faceted] search results.
+xref:query-guide:collapse-and-expand-results.adoc[Collapsing] and 
xref:query-guide:result-clustering.adoc[clustering] results offer compelling 
features for e-commerce and storefronts.
+xref:query-guide:streaming-expressions.adoc[Streaming expressions] allow you 
to conduct analytics on an entire corpus, a subset matching a query, or a 
random sample from a set of documents.
+Powerful xref:query-guide:math-expressions.adoc[math expressions] build on 
streaming expressions to provide the backbone for advanced analysis and 
predictive analytics use cases.
 
-Flexible schema configurations allow nearly any type of data to be stored in 
Solr.
-The xref:indexing-guide:schema-elements.adoc[] has more details on these 
options.
+Advanced relevancy tuning is also supported;
+Solr provides access to almost all of Lucene's text analysis features 
including tokenization, stemming, synonyms and much more, allowing you to tune 
relevancy based on knowledge of your users and your domain.
+Solr even allows for customization of relevancy via machine learning using the 
xref:query-guide:learning-to-rank.adoc[] feature.
 
-Solr offers support for the simplest keyword searching through to complex 
queries on multiple fields and faceted search results.
-Collapsing and clustering results offer compelling features for e-commerce and 
storefronts.
-Powerful math expressions provide the backbone for advanced analytics use 
cases.
-The xref:query-guide:query-syntax-and-parsers.adoc[] has more information 
about searching and queries.
+Queries are transmitted to Solr via HTTP 1.1 or 2.0 requests and the response 
is typically a list of structured document descriptors.
+In the classic example, 10 descriptors are returned, each including a URL to 
locate the document (often rendered as "10 blue links"). However, Solr can go 
far beyond document locators and many other types of document metadata might 
also be included.  Flexible schema configurations allow nearly any type of 
metadata to be associated with a document indexed in Solr.
+The xref:indexing-guide:schema-elements.adoc[schema elements] page of the 
indexing guide has more details on these options.
 
-If Solr's capabilities are not impressive enough, its ability to handle very 
high-volume applications should do the trick.
+JSON is the default response format, but it could also be XML, CSV, optimized 
binary, or (with customization) any format you desire.
+This means that a wide variety of clients will be able to use Solr. Such 
clients might be web applications, browsers, rich client applications, or 
mobile devices.
+Any platform capable of HTTP can talk to Solr.

Review Comment:
   Should we rephrase to "Any platform capable of communicating in HTTP can be 
used to interact with Solr."?



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org
For additional commands, e-mail: issues-h...@solr.apache.org

Reply via email to