Merge branch 'main' into DOC-5462

Author: rrelledge

.github/workflows/autocomment_jira_link.yaml

@@ -2,8 +2,6 @@ name: autocomment_jira_link
 
 on:
   pull_request:
-    paths:
-    - 'content/**'
     types:
       - opened
 permissions:
@@ -24,14 +22,6 @@ jobs:
           REPO: ${{ github.repository }}
           BRANCH_NAME: ${{ github.event.pull_request.head.ref }}
         run: |
-          set -e
-
-          CREATE_COMMENT_URL="https://api.github.com/repos/${REPO}/issues/${PR_NUMBER}/comments"
-          
-          JIRA_TICKET=$(grep -Eo '^DOC-[0-9]+' <<< "$BRANCH_NAME")
-          JIRA_LINK="https://redislabs.atlassian.net/browse/${JIRA_TICKET}"
-          COMMENT="[${JIRA_TICKET}](${JIRA_LINK})"
-          
           generate_post_data()
           {
             cat <<EOF
@@ -41,6 +31,12 @@ jobs:
           }
 
           if [[ "$BRANCH_NAME" == DOC-* ]]; then
+            CREATE_COMMENT_URL="https://api.github.com/repos/${REPO}/issues/${PR_NUMBER}/comments"
+
+            JIRA_TICKET=$(grep -Eo '^DOC-[0-9]+' <<< "$BRANCH_NAME")
+            JIRA_LINK="https://redislabs.atlassian.net/browse/${JIRA_TICKET}"
+            COMMENT="[${JIRA_TICKET}](${JIRA_LINK})"
+
             # Write comment on pull request
             curl -Ls \
               -X POST \

.github/workflows/autocomment.yaml renamed to .github/workflows/autocomment_staging_links.yaml

@@ -1,4 +1,4 @@
-name: Auto Comment on PR
+name: autocomment_staging_links
 
 on:
   pull_request:
@@ -38,7 +38,7 @@ jobs:
                               -H "X-GitHub-Api-Version: 2022-11-28" \
                               -H "Authorization: Bearer ${GITHUB_TOKEN}" \
                               $CREATE_COMMENT_URL \
-                              | jq -r '.[] | select(.user.login == "github-actions[bot]")'
+                              | jq -r '.[] | select(.user.login == "github-actions[bot]" and ((.body // "") | contains("Staging links:")))'
                             )
           EXISTING_COMMENT_ID=$(jq -r '.id' <<<"$EXISTING_COMMENT_JSON")
           EXISTING_COMMENT=$(jq -r '.body' <<<"$EXISTING_COMMENT_JSON")
@@ -50,7 +50,7 @@ jobs:
             -H "Authorization: Bearer ${GITHUB_TOKEN}" \
             $FILES_URL \
               | jq -r --arg prefix $BRANCH_NAME/ '.[] | select(((.filename | test("content/(?!.*embed).*\\.md")) and .status != "removed")) | ($prefix + .filename)' \
-              | sed -E -e 's|(^[^/]+/)([^/]+/)|\1|' -e 's|^|https://redis.io/docs/staging/|' -e 's|\/(_?index)?\.md|\/|' \
+              | sed -E -e 's|(^[^/]+/)([^/]+/)|\1|' -e 's|^|https://redis.io/docs/staging/|' -e 's|(\/_?index)?\.md|\/|' \
               | sort \
               | uniq)
 

.github/workflows/k8s_apis_sync.yaml

@@ -50,7 +50,7 @@ jobs:
         run: |-
           mkdir artifacts
           mkdir templates
-          cp content/operate/kubernetes/reference/kubernetes-api-reference-template.tmpl templates/template.tmpl
+          cp content/operate/kubernetes/reference/api/kubernetes-api-reference-template.tmpl templates/template.tmpl
 
           crdoc --resources crds/reaadb_crd.yaml --output artifacts/redis_enterprise_active_active_database_api.md --template templates/template.tmpl
           sed -E -i 's/^### RedisEnterpriseActiveActiveDatabase\./### /g' artifacts/redis_enterprise_active_active_database_api.md
@@ -80,6 +80,80 @@ jobs:
           sed -E -i 's/\[index\]/\[\]/g' artifacts/redis_enterprise_remote_cluster_api.md
           awk '/(#[^")]+)index/ {gsub(/index/,"")}; {print}' artifacts/redis_enterprise_remote_cluster_api.md > _tmp.md && mv _tmp.md artifacts/redis_enterprise_remote_cluster_api.md
 
+      - name: 'Remove fields without description'
+        run: |-
+          file="artifacts/redis_enterprise_cluster_api.md"
+          empty_fields_file="content/operate/kubernetes/reference/api/redis_enterprise_cluster_empty_fields"
+
+          # Read empty fields and process them
+          while IFS= read -r field; do
+              # Skip empty lines and comments
+              [[ -z "$field" || "$field" =~ ^# ]] && continue
+
+              # Convert field path to section header pattern
+              section_pattern="${field}"
+
+              # Remove subsections that go deeper than [index] level
+              # Keep: spec.extraEnvVars
+              # Keep: spec.extraEnvVars[index]
+              # Remove: spec.extraEnvVars[index].valueFrom
+              # Remove: spec.extraEnvVars[index].valueFrom.fieldRef
+              awk -v base_pattern="${section_pattern}" '
+              BEGIN { skip = 0 }
+              /^### / {
+                  # Check if this line matches a pattern we want to remove
+                  section = $0
+                  gsub(/^### /, "", section)
+
+                  # If it starts with our base pattern
+                  if (index(section, base_pattern) == 1) {
+                      remainder = substr(section, length(base_pattern) + 1)
+
+                      # If remainder is empty, keep it (main section)
+                      if (remainder == "") {
+                          skip = 0
+                      }
+                      # If remainder is just [index], keep it
+                      else if (remainder == "[index]") {
+                          skip = 0
+                      }
+                      # If remainder starts with [index]. (has more after [index]), remove it
+                      else if (index(remainder, "[index].") == 1) {
+                          skip = 1
+                          next
+                      }
+                      # If remainder starts with . (direct subsection), remove it
+                      else if (index(remainder, ".") == 1) {
+                          skip = 1
+                          next
+                      }
+                      # If remainder starts with []. (direct subsection), remove it
+                      else if (index(remainder, "[].") == 1) {
+                          skip = 1
+                          next
+                      }
+                      # Otherwise keep it
+                      else {
+                          skip = 0
+                      }
+                  } else {
+                      # Different section, stop skipping
+                      skip = 0
+                  }
+              }
+
+              skip == 0 { print }
+              ' "$file" > "${file}.tmp" && mv "${file}.tmp" "$file"
+
+          done < "$empty_fields_file"
+
+      - name: 'Fix link titles'
+        run: |-
+          sed -E -i 's/linkTitle: RedisEnterpriseActiveActiveDatabase API Reference/linkTitle: REAADB API/g' artifacts/redis_enterprise_active_active_database_api.md
+          sed -E -i 's/linkTitle: RedisEnterpriseCluster API Reference/linkTitle: REC API/g' artifacts/redis_enterprise_cluster_api.md
+          sed -E -i 's/linkTitle: RedisEnterpriseDatabase API Reference/linkTitle: REDB API/g' artifacts/redis_enterprise_database_api.md
+          sed -E -i 's/linkTitle: RedisEnterpriseRemoteCluster API Reference/linkTitle: RERC API/g' artifacts/redis_enterprise_remote_cluster_api.md
+
       - name: 'Generate YAML snippets'
         run: |-
           function formatYamlSnippet() {
@@ -128,14 +202,12 @@ jobs:
 
           git checkout -b "${BRANCH}"
 
-          cp artifacts/redis_enterprise_active_active_database_api.md content/operate/kubernetes/reference/
-          cp artifacts/redis_enterprise_cluster_api.md content/operate/kubernetes/reference/
-          cp artifacts/redis_enterprise_database_api.md content/operate/kubernetes/reference/
-          cp artifacts/redis_enterprise_remote_cluster_api.md content/operate/kubernetes/reference/
-
-          git apply content/operate/kubernetes/reference/kubernetes-api-reference-frontmatter.patch
+          cp artifacts/redis_enterprise_active_active_database_api.md content/operate/kubernetes/reference/api/
+          cp artifacts/redis_enterprise_cluster_api.md content/operate/kubernetes/reference/api/
+          cp artifacts/redis_enterprise_database_api.md content/operate/kubernetes/reference/api/
+          cp artifacts/redis_enterprise_remote_cluster_api.md content/operate/kubernetes/reference/api/
 
-          git add content/operate/kubernetes/reference/
+          git add content/operate/kubernetes/reference/api/
           git add content/embeds/k8s/
 
           git commit -m "k8s api docs ${RELEASE}"

build/local_examples.py

@@ -51,6 +51,24 @@ def get_client_name_from_language(language: str) -> str:
     return LANGUAGE_TO_CLIENT.get(language, language.title())
 
 
+def get_client_name_from_language_and_path(language: str, path: str) -> str:
+    """Get client name from language with path-based overrides.
+
+    For Java (.java) files, override based on path substrings:
+    - If 'lettuce-async' in path -> Java-Async
+    - If 'lettuce-reactive' in path -> Java-Reactive
+
+    Substring checks are case-sensitive and can appear anywhere in the path.
+    """
+    if language == 'java':
+        if 'lettuce-async' in path:
+            return 'Java-Async'
+        if 'lettuce-reactive' in path:
+            return 'Java-Reactive'
+    # Default behavior for all languages (and Java fallback)
+    return get_client_name_from_language(language)
+
+
 def get_example_id_from_file(path: str) -> str:
     """Extract example ID from the first line of a file."""
     try:
@@ -136,8 +154,8 @@ def process_local_examples(local_examples_dir: str = 'local_examples',
             # Process with Example class
             example = Example(language, target_file)
 
-            # Get client name
-            client_name = get_client_name_from_language(language)
+            # Get client name (with Java path-based overrides)
+            client_name = get_client_name_from_language_and_path(language, source_file)
 
             # Create metadata
             example_metadata = {

config.toml

@@ -45,7 +45,7 @@ tagManagerId = "GTM-TKZ6J9R"
 gitHubRepo = "https://github.com/redis/docs"
 
 # Display and sort order for client examples
-clientsExamples = ["Python", "Node.js", "Java-Sync", "Java-Async", "Java-Reactive", "Go", "C#", "RedisVL"]
+clientsExamples = ["Python", "Node.js", "Java-Sync", "Java-Async", "Java-Reactive", "Go", "C#", "RedisVL", "PHP"]
 searchService = "/convai/api/search-service"
 ratingsService = "/docusight/api/rate"
 
@@ -66,6 +66,7 @@ rdi_current_version = "1.12.3"
 "Go"={quickstartSlug="go"}
 "C#"={quickstartSlug="dotnet"}
 "RedisVL"={quickstartSlug="redis-vl"}
+"PHP"={quickstartSlug="php"}
 
 # Markup
 [markup]

content/commands/info.md

@@ -551,14 +551,14 @@ _Redis Query Engine fields_
 *   `search_fields_geoshape_Sortable`: The total number of `SORTABLE GEOSHAPE` fields across all indexes in the shard. This field appears only if its value is larger than 0. <sup>[2](#tnote-2)</sup>
 *   `search_fields_geoshape_NoIndex`: The total number of `NOINDEX GEOSHAPE` fields across all indexes in the shard; i.e., used for sorting only but not indexed. This field appears only if its value is larger than 0. <sup>[2](#tnote-2)</sup>
 *   `search_fields_<field>_IndexErrors`: The total number of indexing failures caused by attempts to index a document containing <field> field. <sup>[1](#tnote-1)</sup>
-*   `search_used_memory_indexes`: The total memory allocated by all indexes in the shard in bytes. <sup>[1](#tnote-1)</sup>
-*   `search_used_memory_indexes_human`: The total memory allocated by all indexes in the shard in MB. <sup>[1](#tnote-1)</sup>
-*   `search_smallest_memory_index`: The memory usage of the index with the smallest memory usage in the shard in bytes. <sup>[1](#tnote-1)</sup>
-*   `search_smallest_memory_index_human`: The memory usage of the index with the smallest memory usage in the shard in MB. <sup>[1](#tnote-1)</sup>
-*   `search_largest_memory_index`: The memory usage of the index with the largest memory usage in the shard in bytes. <sup>[1](#tnote-1)</sup>
-*   `search_largest_memory_index_human`: The memory usage of the index with the largest memory usage in the shard in MB. <sup>[1](#tnote-1)</sup>
-*   `search_total_indexing_time`: The total time spent on indexing operations, excluding the background indexing of vectors in the HNSW graph. <sup>[1](#tnote-1)</sup>
 *   `search_used_memory_vector_index`: The total memory usage of all vector indexes in the shard. <sup>[1](#tnote-1)</sup>
+*   `search_used_memory_indexes`: The estimated total memory allocated by all indexes in the shard in bytes (including vector indexes memory accounted in `search_used_memory_vector_index`). <sup>[1](#tnote-1)</sup>
+*   `search_used_memory_indexes_human`: The estimated total memory allocated by all indexes in the shard in MB. <sup>[1](#tnote-1)</sup>
+*   `search_smallest_memory_index`: The estimated memory usage of the index with the smallest memory usage in the shard in bytes. <sup>[1](#tnote-1)</sup>
+*   `search_smallest_memory_index_human`: The estimated memory usage of the index with the smallest memory usage in the shard in MB. <sup>[1](#tnote-1)</sup>
+*   `search_largest_memory_index`: The estimated memory usage of the index with the largest memory usage in the shard in bytes. <sup>[1](#tnote-1)</sup>
+*   `search_largest_memory_index_human`: The estimated memory usage of the index with the largest memory usage in the shard in MB. <sup>[1](#tnote-1)</sup>
+*   `search_total_indexing_time`: The total time spent on indexing operations, excluding the background indexing of vectors in the HNSW graph. <sup>[1](#tnote-1)</sup>
 *   `search_bytes_collected`: The total amount of memory freed by the garbage collectors from indexes in the shard memory in bytes. <sup>[1](#tnote-1)</sup>
 *   `search_total_cycles`: The total number of garbage collection cycles executed. <sup>[1](#tnote-1)</sup>
 *   `search_total_ms_run`: The total duration of all garbage collection cycles in the shard, measured in milliseconds. <sup>[1](#tnote-1)</sup>

content/commands/set.md

@@ -180,18 +180,20 @@ The script should be called with `EVAL ...script... 1 resource-name token-value`
     tab1="RESP2" 
     tab2="RESP3" >}}
 
-Any of the following:
-* [Nil reply](../../develop/reference/protocol-spec#bulk-strings): `GET` not given: Operation was aborted (conflict with one of the `XX`/`NX` options).
-* [Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK`. `GET` not given: The key was set.
-* [Nil reply](../../develop/reference/protocol-spec#bulk-strings): `GET` given: The key didn't exist before the `SET`.
-* [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings): `GET` given: The previous value of the key.
+* If `GET` was not specified, any of the following:
+  * [Nil reply](../../develop/reference/protocol-spec#bulk-strings): Operation was aborted (conflict with one of the `XX`/`NX` options). The key was not set.
+  * [Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK`: The key was set.
+* If `GET` was specified, any of the following:
+  * [Nil reply](../../develop/reference/protocol-spec#bulk-strings): The key didn't exist before the `SET`. If `XX` was specified, the key was not set. Otherwise, the key was set.
+  * [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings): The previous value of the key. If `NX` was specified, the key was not set. Otherwise, the key was set.
 
 -tab-sep-
 
-Any of the following:
-* [Null reply](../../develop/reference/protocol-spec#nulls): `GET` not given: Operation was aborted (conflict with one of the `XX`/`NX` options).
-* [Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK`. `GET` not given: The key was set.
-* [Null reply](../../develop/reference/protocol-spec#nulls): `GET` given: The key didn't exist before the `SET`.
-* [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings): `GET` given: The previous value of the key.
+* If `GET` was not specified, any of the following:
+  * [Null reply](../../develop/reference/protocol-spec#nulls): Operation was aborted (conflict with one of the `XX`/`NX` options). The key was not set.
+  * [Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK`: The key was set.
+* If `GET` was specified, any of the following:
+  * [Null reply](../../develop/reference/protocol-spec#nulls): The key didn't exist before the `SET`. If `XX` was specified, the key was not set. Otherwise, the key was set.
+  * [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings): The previous value of the key. If `NX` was specified, the key was not set. Otherwise, the key was set.
 
 {{< /multitabs >}}

content/commands/vadd.md

@@ -38,7 +38,7 @@ is the name of the key that will hold the vector set data.
 <details open>
 <summary><code>FP32 vector or VALUES num vector</code></summary>
 
-either a 32-bit floating point (FP32) blob of values or `num` floating point numbers as strings.
+either a 32-bit floating point (FP32) blob of values or `num` floating point numbers as strings. When using the FP32 format, the blob must use little-endian encoding. On platforms with different endianness, you should either manually adjust the byte order or use the VALUES syntax instead.
 </details>
 
 <details open>

content/commands/vemb.md

@@ -82,7 +82,7 @@ One of the following:
 * [Array reply](../../develop/reference/protocol-spec#arrays): consisting of the following elements:
     1. The quantization type as a [simple string](../../develop/reference/protocol-spec#simple-strings): `fp32`, `bin`, or `q8`.
     1. A [bulk string](../../develop/reference/protocol-spec#bulk-strings) blob with the following raw data:
-        * 4-byte floats for fp32
+        * 4-byte floats for fp32 (little-endian encoding)
         * A bitmap for binary quantization
         * A byte array for q8
     1. The L2 norm, as a [simple string](../../develop/reference/protocol-spec#simple-strings), of the vector before normalization.
@@ -95,7 +95,7 @@ One of the following:
 * [Array reply](../../develop/reference/protocol-spec#arrays): consisting of the following elements:
     1. The quantization type as a [simple string](../../develop/reference/protocol-spec#simple-strings): `fp32`, `bin`, or `q8`.
     1. A [bulk string](../../develop/reference/protocol-spec#bulk-strings) blob with the following raw data:
-        * 4-byte floats for fp32
+        * 4-byte floats for fp32 (little-endian encoding)
         * A bitmap for binary quantization
         * A byte array for q8
     1. The [double](../../develop/reference/protocol-spec#doubles) L2 norm of the vector before normalization.