You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@solr.apache.org by ho...@apache.org on 2023/11/16 15:21:52 UTC
(solr) branch main updated: SOLR-17075: Fix ref-guide links and renable site checks by default (#2075)
This is an automated email from the ASF dual-hosted git repository.
houston pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/solr.git
The following commit(s) were added to refs/heads/main by this push:
new ddcec23121c SOLR-17075: Fix ref-guide links and renable site checks by default (#2075)
ddcec23121c is described below
commit ddcec23121c2a66ad18b456b1326c473f95525c8
Author: Houston Putman <ho...@apache.org>
AuthorDate: Thu Nov 16 10:21:44 2023 -0500
SOLR-17075: Fix ref-guide links and renable site checks by default (#2075)
---
solr/solr-ref-guide/build.gradle | 2 +-
.../modules/deployment-guide/pages/circuit-breakers.adoc | 2 +-
.../modules/getting-started/pages/tutorial-techproducts.adoc | 4 ++--
solr/solr-ref-guide/modules/indexing-guide/pages/post-tool.adoc | 2 +-
solr/solr-ref-guide/modules/query-guide/pages/other-parsers.adoc | 2 +-
.../modules/upgrade-notes/pages/major-changes-in-solr-9.adoc | 4 ++--
6 files changed, 8 insertions(+), 8 deletions(-)
diff --git a/solr/solr-ref-guide/build.gradle b/solr/solr-ref-guide/build.gradle
index 39554ab7783..fa73022ba5c 100644
--- a/solr/solr-ref-guide/build.gradle
+++ b/solr/solr-ref-guide/build.gradle
@@ -40,7 +40,7 @@ def escapeYamlSingleQuotesString(props) {
// Attach building the ref guide to standard convention tasks. This
// can be optionally turned off (see SOLR-15670).
-var defaultRefGuideInclude = file('${rootDir}/.git').exists()
+var defaultRefGuideInclude = file("${rootDir}/.git").exists()
if (propertyOrEnvOrDefault('refguide.include', 'SOLR_REF_GUIDE_INCLUDE', "${defaultRefGuideInclude}").toBoolean()) {
check.dependsOn 'checkSiteLinks'
assemble.dependsOn 'buildLocalSite'
diff --git a/solr/solr-ref-guide/modules/deployment-guide/pages/circuit-breakers.adoc b/solr/solr-ref-guide/modules/deployment-guide/pages/circuit-breakers.adoc
index 47da5f386fe..f7f61f8dc90 100644
--- a/solr/solr-ref-guide/modules/deployment-guide/pages/circuit-breakers.adoc
+++ b/solr/solr-ref-guide/modules/deployment-guide/pages/circuit-breakers.adoc
@@ -29,7 +29,7 @@ It is up to the client to handle this error and potentially build retry logic as
In a sharded collection, when a circuit breaker trips on one shard, the entire query will fail,
even if the other shard requests succeed. This will multiply the failures seen by the end users.
Setting the `shards.tolerant=true` parameter on requests can help with graceful degradation when
-circuit breaker thresholds are reached on some nodes. See <<solrcloud-distributed-requests#shards-tolerant-parameter,`shards.tolerant`>> for details.
+circuit breaker thresholds are reached on some nodes. See the xref:deployment-guide:solrcloud-distributed-requests.adoc#shards-tolerant-parameter[`shards.tolerant` Parameter] for details.
== Circuit Breaker Configurations
All circuit breaker configurations are listed as independent `<circuitBreaker>` entries in `solrconfig.xml` as shown below.
diff --git a/solr/solr-ref-guide/modules/getting-started/pages/tutorial-techproducts.adoc b/solr/solr-ref-guide/modules/getting-started/pages/tutorial-techproducts.adoc
index 874acf5fdf4..7aa78a38f58 100644
--- a/solr/solr-ref-guide/modules/getting-started/pages/tutorial-techproducts.adoc
+++ b/solr/solr-ref-guide/modules/getting-started/pages/tutorial-techproducts.adoc
@@ -164,8 +164,8 @@ We'll use this tool for the indexing examples below.
You'll need a command shell to run some of the following examples, rooted in the Solr install directory; the shell from where you launched Solr works just fine.
-NOTE: Currently the `bin/post` tool does not have a comparable Windows script, but the underlying Java program invoked is available.
-We'll show examples below for Windows, but you can also see the section xref:indexing-guide:post-tool.adoc#post-tool-windows-support[Post Tool Windows Support].
+NOTE: Currently the `bin/post` tool does not have a comparable Windows script, but the `bin/solr post` command is available on Windows.
+See the section xref:indexing-guide:post-tool.adoc[] for more information.
The data we will index is in the `example/exampledocs` directory.
The documents are in a mix of document formats (JSON, CSV, etc.), and fortunately we can index them all at once:
diff --git a/solr/solr-ref-guide/modules/indexing-guide/pages/post-tool.adoc b/solr/solr-ref-guide/modules/indexing-guide/pages/post-tool.adoc
index f285ac6486d..c1ef5876923 100644
--- a/solr/solr-ref-guide/modules/indexing-guide/pages/post-tool.adoc
+++ b/solr/solr-ref-guide/modules/indexing-guide/pages/post-tool.adoc
@@ -19,7 +19,7 @@
Solr includes a simple command line tool for POSTing various types of content to a Solr server.
The tool is `bin/solr post`.
-The bin/solr post tool is a Unix shell script; for Windows (non-Cygwin) usage, see the section <<Post Tool Windows Support>> below.
+The bin/solr post tool is a Unix shell script; for Windows (non-Cygwin) usage,use `bin/solr.cmd post`.
NOTE: This tool is meant for use by new users exploring Solr's capabilities, and is not intended as a robust solution to be used for indexing documents into production systems.
diff --git a/solr/solr-ref-guide/modules/query-guide/pages/other-parsers.adoc b/solr/solr-ref-guide/modules/query-guide/pages/other-parsers.adoc
index 262e41b1992..a69fd3e9e97 100644
--- a/solr/solr-ref-guide/modules/query-guide/pages/other-parsers.adoc
+++ b/solr/solr-ref-guide/modules/query-guide/pages/other-parsers.adoc
@@ -369,7 +369,7 @@ The graph is built according to linkages between documents based on the terms fo
Supported field types are point fields with docValues enabled, or string fields with `indexed=true` or `docValues=true`.
-TIP: For string fields which are `indexed=false` and `docValues=true`, please refer to the javadocs for {lucene-javadocs}/sandbox/org/apache/lucene/sandbox/search/DocValuesTermsQuery.html[`DocValuesTermsQuery`] for its performance characteristics so `indexed=true` will perform better for most use-cases.
+TIP: For string fields which are `indexed=false` and `docValues=true`, please refer to the javadocs for {lucene-javadocs}/core/org/apache/lucene/document/SortedDocValuesField.html#newSlowSetQuery(java.lang.String,org.apache.lucene.util.BytesRef...)[`SortedDocValuesField.newSlowSetQuery()`] for its performance characteristics so `indexed=true` will perform better for most use-cases.
=== Graph Query Parameters
diff --git a/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-9.adoc b/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-9.adoc
index ecaf52fa859..fc83e288e41 100644
--- a/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-9.adoc
+++ b/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-9.adoc
@@ -69,13 +69,13 @@ Due to changes in Lucene 9, that isn't possible any more.
== Solr 9.5
=== Curator upgraded to 5.5.0 and requires Zookeeper 3.5.x or higher
-xref:upgrade-notes:major-changes-in-solr-9.html#solr-8-2[Solr 8.2 recommended using Zookeeper 3.5.5] and now with Curator 5.5.0 requires https://curator.apache.org/docs/breaking-changes/[Zookeeper 3.5.x or higher]. This primarily affects users of `hadoop-auth`, but usage of Curator could affect other parts of Solr.
+<<#solr-8-2,Solr 8.2 recommended using Zookeeper 3.5.5>> and now with Curator 5.5.0 requires https://curator.apache.org/docs/breaking-changes/[Zookeeper 3.5.x or higher]. This primarily affects users of `hadoop-auth`, but usage of Curator could affect other parts of Solr.
== Solr 9.4
=== The Built-In Config Sets
* The build in ConfigSets (`_default` and `sample_techproducts_configs`), now use a default `autoSoftCommit` time of 3 seconds,
meaning that documents will be searchable within 3 seconds of uploading them.
-Please refer to the xref:configuration-guide:commits-transaction-logs.html#hard-commits-vs-soft-commits[Soft Commit documentation]
+Please refer to the xref:configuration-guide:commits-transaction-logs.adoc#hard-commits-vs-soft-commits[Soft Commit documentation]
for more information on how this change will effect you.
Upgrading existing clouds and use-cases that have custom configSets will not be affected by this change.