Apply Artjoms' feedback

mpfuster · mpfuster · commit eff3196abff1 · 2026-03-12T13:48:13.000Z
diff --git a/product_docs/docs/pgaa/1.3/index.mdx b/product_docs/docs/pgaa/1.3/index.mdx
@@ -5,25 +5,6 @@ navRootedTo: /edb-postgres-ai
 description: Explore EDB Postgres® Analytics Accelerator with concepts, how-tos, and reference material.
 redirects:
 - /purl/analytics
-
-- /edb-postgres-ai/latest/analytics/
-- /edb-postgres-ai/latest/analytics/101
-- /edb-postgres-ai/latest/analytics/201
-- /edb-postgres-ai/latest/analytics/301
-- /edb-postgres-ai/latest/analytics/create-lakehouse-cluster
-- /edb-postgres-ai/latest/analytics/delta_lake
-- /edb-postgres-ai/latest/analytics/getting-setup
-- /edb-postgres-ai/latest/analytics/how-to-iceberg-reads-writes-with-catalog
-- /edb-postgres-ai/latest/analytics/how-to-lakehouse-read-with-without-catalog
-- /edb-postgres-ai/latest/analytics/how-to-read-write-without-catalog
-- /edb-postgres-ai/latest/analytics/how-to-third-party-catalog
-- /edb-postgres-ai/latest/analytics/iceberg
-- /edb-postgres-ai/latest/analytics/lakehouse
-- /edb-postgres-ai/latest/analytics/learn
-- /edb-postgres-ai/latest/analytics/paths
-- /edb-postgres-ai/latest/analytics/personas
-- /edb-postgres-ai/latest/analytics/tiered_tables
-
 - /edb-postgres-ai/1.3/analytics/
 - /edb-postgres-ai/1.3/analytics/101
 - /edb-postgres-ai/1.3/analytics/201
@@ -41,7 +22,6 @@ redirects:
 - /edb-postgres-ai/1.3/analytics/paths
 - /edb-postgres-ai/1.3/analytics/personas
 - /edb-postgres-ai/1.3/analytics/tiered_tables
-
 - /edb-postgres-ai/1.2/analytics/
 - /edb-postgres-ai/1.2/analytics/delta_lake
 - /edb-postgres-ai/1.2/analytics/iceberg
diff --git a/product_docs/docs/pgaa/1.3/optimize_performance.mdx b/product_docs/docs/pgaa/1.3/optimize_performance.mdx
@@ -4,7 +4,8 @@ navTitle: Optimizing query performance
 description: Maximize query speeds by managing DirectScan execution and troubleshooting path fallbacks.
 deepToC: true
 redirects:
-- /edb-postgres-ai/latest/analytics/reference/directscan/
+- /edb-postgres-ai/1.3/analytics/reference/directscan/
+- /edb-postgres-ai/1.2/analytics/reference/directscan/
 ---
 
 The Postgres Analytics Accelerator (PGAA) achieves its high performance by offloading analytical workloads to Seafowl and Apache Spark, a vectorized execution engine designed for massive scale. By understanding how PGAA selects execution paths, you can ensure your queries stay on the "fast path" for maximum acceleration.
diff --git a/product_docs/docs/pgaa/1.3/overview/architecture.mdx b/product_docs/docs/pgaa/1.3/overview/architecture.mdx
@@ -4,7 +4,6 @@ navTitle: Architecture
 description: Overview of the Analytics Accelerator architecture for unified transactional and analytical processing.
 redirects:
 - /edb-postgres-ai/1.3/analytics/architecture/
-- /edb-postgres-ai/latest/analytics/architecture/
 - /edb-postgres-ai/1.2/analytics/generic-concepts/
 ---
 
diff --git a/product_docs/docs/pgaa/1.3/overview/concepts.mdx b/product_docs/docs/pgaa/1.3/overview/concepts.mdx
@@ -8,9 +8,6 @@ redirects:
 - /edb-postgres-ai/1.2/analytics/learn/explained/analytics-concepts
 - /edb-postgres-ai/1.2/analytics/learn/explained/generic-concepts
 - /edb-postgres-ai/1.2/analytics/learn/explained/terminology
-- /edb-postgres-ai/latest/analytics/analytics-concepts/
-- /edb-postgres-ai/latest/analytics/terminology/
-- /edb-postgres-ai/latest/analytics/generic-concepts/
 - /edb-postgres-ai/1.3/analytics/analytics-concepts/
 - /edb-postgres-ai/1.3/analytics/terminology/
 - /edb-postgres-ai/1.3/analytics/generic-concepts/
diff --git a/product_docs/docs/pgaa/1.3/overview/quick_start.mdx b/product_docs/docs/pgaa/1.3/overview/quick_start.mdx
@@ -4,7 +4,6 @@ navTitle: Quickstart
 description: Install PGAA on a Postgres instance and query sample data.
 redirects:
 - /edb-postgres-ai/1.2/analytics/quick_start/
-- /edb-postgres-ai/latest/analytics/quick_start/
 - /edb-postgres-ai/1.3/analytics/quick_start/
 ---
 
diff --git a/product_docs/docs/pgaa/1.3/reference/datasets.mdx b/product_docs/docs/pgaa/1.3/reference/datasets.mdx
@@ -4,7 +4,6 @@ navTitle: Benchmark datasets
 description: Benchmark datasets available for PGAA.
 redirects:
 - /edb-postgres-ai/1.3/analytics/reference/datasets
-- /edb-postgres-ai/latest/analytics/reference/datasets
 - /edb-postgres-ai/1.2/analytics/reference/datasets
 ---
 
diff --git a/product_docs/docs/pgaa/1.3/reference/functions.mdx b/product_docs/docs/pgaa/1.3/reference/functions.mdx
@@ -6,8 +6,6 @@ deepToC: true
 redirects:
 - /edb-postgres-ai/1.3/analytics/reference/functions
 - /edb-postgres-ai/1.3/analytics/reference/pgaa_functions
-- /edb-postgres-ai/latest/analytics/reference/functions
-- /edb-postgres-ai/latest/analytics/reference/pgaa_functions
 - /edb-postgres-ai/1.2/analytics/reference/functions
 - /edb-postgres-ai/1.2/analytics/reference/pgaa_functions
 ---
diff --git a/product_docs/docs/pgaa/1.3/reference/index.mdx b/product_docs/docs/pgaa/1.3/reference/index.mdx
@@ -11,13 +11,6 @@ redirects:
 - /edb-postgres-ai/1.3/analytics/reference/loadingdata
 - /edb-postgres-ai/1.3/analytics/reference/queries
 - /edb-postgres-ai/1.3/analytics/reference/users
-- /edb-postgres-ai/latest/analytics/reference/
-- /edb-postgres-ai/latest/analytics/reference/delta_tables
-- /edb-postgres-ai/latest/analytics/reference/directscan
-- /edb-postgres-ai/latest/analytics/reference/instances
-- /edb-postgres-ai/latest/analytics/reference/loadingdata
-- /edb-postgres-ai/latest/analytics/reference/queries
-- /edb-postgres-ai/latest/analytics/reference/users
 - /edb-postgres-ai/1.2/analytics/reference/
 - /edb-postgres-ai/1.2/analytics/reference/delta_tables
 - /edb-postgres-ai/1.2/analytics/reference/directscan
diff --git a/product_docs/docs/pgaa/1.7/index.mdx b/product_docs/docs/pgaa/1.7/index.mdx
@@ -5,24 +5,24 @@ navRootedTo: /edb-postgres-ai
 description: Explore EDB Postgres Analytics Accelerator with concepts, how-tos, and reference material.
 redirects:
 - /purl/analytics
-- /edb-postgres-ai/preview/analytics/
-- /edb-postgres-ai/preview/analytics/101/
-- /edb-postgres-ai/preview/analytics/201/
-- /edb-postgres-ai/preview/analytics/301/
-- /edb-postgres-ai/preview/analytics/create-lakehouse-cluster/
-- /edb-postgres-ai/preview/analytics/delta_lake/
-- /edb-postgres-ai/preview/analytics/getting-setup/
-- /edb-postgres-ai/preview/analytics/how-to-iceberg-reads-writes-with-catalog/
-- /edb-postgres-ai/preview/analytics/how-to-lakehouse-read-with-without-catalog/
-- /edb-postgres-ai/preview/analytics/how-to-read-write-without-catalog/
-- /edb-postgres-ai/preview/analytics/how-to-third-party-catalog/
-- /edb-postgres-ai/preview/analytics/iceberg/
-- /edb-postgres-ai/preview/analytics/lakehouse/
-- /edb-postgres-ai/preview/analytics/learn/
-- /edb-postgres-ai/preview/analytics/paths/
-- /edb-postgres-ai/preview/analytics/personas/
-- /edb-postgres-ai/preview/analytics/tiered_tables
-- /edb-postgres-ai/preview/analytics/tiered_tables_howto/
+- /edb-postgres-ai/latest/analytics/
+- /edb-postgres-ai/latest/analytics/101/
+- /edb-postgres-ai/latest/analytics/201/
+- /edb-postgres-ai/latest/analytics/301/
+- /edb-postgres-ai/latest/analytics/create-lakehouse-cluster/
+- /edb-postgres-ai/latest/analytics/delta_lake/
+- /edb-postgres-ai/latest/analytics/getting-setup/
+- /edb-postgres-ai/latest/analytics/how-to-iceberg-reads-writes-with-catalog/
+- /edb-postgres-ai/latest/analytics/how-to-lakehouse-read-with-without-catalog/
+- /edb-postgres-ai/latest/analytics/how-to-read-write-without-catalog/
+- /edb-postgres-ai/latest/analytics/how-to-third-party-catalog/
+- /edb-postgres-ai/latest/analytics/iceberg/
+- /edb-postgres-ai/latest/analytics/lakehouse/
+- /edb-postgres-ai/latest/analytics/learn/
+- /edb-postgres-ai/latest/analytics/paths/
+- /edb-postgres-ai/latest/analytics/personas/
+- /edb-postgres-ai/latest/analytics/tiered_tables
+- /edb-postgres-ai/latest/analytics/tiered_tables_howto/
 navigation:
 - release_notes
 - overview
diff --git a/product_docs/docs/pgaa/1.7/monitoring.mdx b/product_docs/docs/pgaa/1.7/monitoring.mdx
@@ -48,7 +48,7 @@ Analytical performance is heavily impacted by the "small file problem", where fr
 
 ### Performing table maintenance with pgaa.launch_task
 
-Maintenance for both Delta and Iceberg tables is handled asynchronously by a native background worker using the `pgaa.launch_task()` function. This allows you to trigger heavy operations without blocking your active SQL session and does not require an external Spark integration.
+Maintenance for both Delta and Iceberg tables is handled asynchronously by a native background worker using the `pgaa.launch_task()` function. This allows you to trigger heavy operations without blocking your active SQL session.
 
 ```sql
 SELECT pgaa.launch_task(
@@ -59,7 +59,7 @@ SELECT pgaa.launch_task(
 ```
 
 !!! Note
-    While Delta Lake supports all task types below, Iceberg tables currently only support the `compaction` operation via this function.
+    While Delta Lake supports all available task types, Iceberg tables currently only support the `compaction` operation. Furthermore, Iceberg compaction does not support the granular configuration keys available for Delta Lake, except for `dry_run`.
 
 Supported task types include:
 
@@ -70,7 +70,7 @@ Supported task types include:
 
 **Examples**
 
-- Use compaction to merge small files into larger, 256MB blocks to speed up scan performance:
+- Use compaction against a Delta Lake table to merge small files into larger, 256MB blocks to speed up scan performance:
 
     ```sql
     SELECT pgaa.launch_task(
diff --git a/product_docs/docs/pgaa/1.7/overview/architecture.mdx b/product_docs/docs/pgaa/1.7/overview/architecture.mdx
@@ -3,7 +3,7 @@ title: Analytics Accelerator architecture
 navTitle: Architecture
 description: Overview of the Analytics Accelerator architecture for unified transactional and analytical processing.
 redirects:
-- /edb-postgres-ai/preview/analytics/architecture/
+- /edb-postgres-ai/latest/analytics/architecture/
 ---
 
 This architecture page provides a high-level technical overview of how the Analytics Accelerator (PGAA) bridges the gap between transactional Postgres and the modern data lake.
diff --git a/product_docs/docs/pgaa/1.7/overview/concepts.mdx b/product_docs/docs/pgaa/1.7/overview/concepts.mdx
@@ -4,9 +4,9 @@ navTitle: Concepts
 description: Glossary of key terms used in the Analytics Accelerator and Hybrid Manager analytics features.
 deepToC: true
 redirects:
-- /edb-postgres-ai/preview/analytics/analytics-concepts/
-- /edb-postgres-ai/preview/analytics/terminology/
-- /edb-postgres-ai/preview/analytics/generic-concepts/
+- /edb-postgres-ai/latest/analytics/analytics-concepts/
+- /edb-postgres-ai/latest/analytics/terminology/
+- /edb-postgres-ai/latest/analytics/generic-concepts/
 ---
 
 
diff --git a/product_docs/docs/pgaa/1.7/overview/quick_start.mdx b/product_docs/docs/pgaa/1.7/overview/quick_start.mdx
@@ -3,7 +3,7 @@ title: Analytics Accelerator quickstart guide
 navTitle: Quickstart
 description: Install PGAA on a Postgres instance and query sample data.
 redirects:
-- /edb-postgres-ai/preview/analytics/quick_start/
+- /edb-postgres-ai/latest/analytics/quick_start/
 ---
 
 In this quickstart guide, you will:
diff --git a/product_docs/docs/pgaa/1.7/reference/datasets.mdx b/product_docs/docs/pgaa/1.7/reference/datasets.mdx
@@ -3,7 +3,7 @@ title: Benchmark datasets
 navTitle: Benchmark datasets
 description: Benchmark datasets available for PGAA.
 redirects:
-- /edb-postgres-ai/preview/analytics/reference/datasets
+- /edb-postgres-ai/latest/analytics/reference/datasets
 ---
 
 You can use our public S3 buckets in AWS that contains sample benchmarking datasets. They are available through the following endpoints:
diff --git a/product_docs/docs/pgaa/1.7/reference/functions.mdx b/product_docs/docs/pgaa/1.7/reference/functions.mdx
@@ -4,8 +4,8 @@ navTitle: Functions
 description: Reference for the functions provided by the PGAA extension.
 deepToC: true
 redirects:
-- /edb-postgres-ai/preview/analytics/reference/functions
-- /edb-postgres-ai/preview/analytics/reference/pgaa_functions
+- /edb-postgres-ai/latest/analytics/reference/functions
+- /edb-postgres-ai/latest/analytics/reference/pgaa_functions
 ---
 
 The reference section is a list of functions available with Analytics Accelerator.
@@ -517,8 +517,9 @@ SELECT pgaa.execute_compaction('lakehouse.inventory_iceberg'::regclass);
 
 Schedules a background maintenance task for an analytical Delta or Iceberg table. 
 
+
 !!! Note
-    While Delta Lake supports all task types below, Iceberg tables currently only support the `compaction` operation via this function.
+    While Delta Lake supports all available task types, Iceberg tables currently only support the `compaction` operation. Furthermore, Iceberg compaction does not support the granular configuration keys available for Delta Lake, except for `dry_run`.
 
 **Synopsis**
 
@@ -550,17 +551,19 @@ The values for the JSONB `task_options` depend on each `task_type`. All options
     "preserve_insertion_order": true,
     "max_concurrent_tasks": 10,
     "max_spill_size": 2147483648,
-    "min_commit_interval": 60
+    "min_commit_interval": 60,
+    "dry_run": false
     }
     ```
 
     Where:
 
-    - `target_size`: Specifies the size of the output files in bytes.
-    - `preserve_insertion_order`: Whether to maintain the existing sort order of rows.
-    - `max_concurrent_tasks`: Limits the number of parallel tasks the executor can run.
-    - `max_spill_size`: Sets the maximum data size in bytes allowed to spill to disk during the process.
-    - `min_commit_interval`: Sets the minimum wait time in seconds between committing updates to the Delta log.
+    - `target_size` (Delta only): Specifies the size of the output files in bytes.
+    - `preserve_insertion_order` (Delta only): Whether to maintain the existing sort order of rows.
+    - `max_concurrent_tasks` (Delta only): Limits the number of parallel tasks the executor can run.
+    - `max_spill_size` (Delta only): Sets the maximum data size in bytes allowed to spill to disk during the process.
+    - `min_commit_interval` (Delta only): Sets the minimum wait time in seconds between committing updates to the Delta log.
+    - `dry_run`: If `true`, calculates and logs the operation, but does not perform compaction.
 
 
 - `zorder` (Delta only): A clustering technique that reorganizes data across multiple columns to improve "data skipping" for queries with filters on those columns. The available `task_options` are:
diff --git a/product_docs/docs/pgaa/1.7/reference/index.mdx b/product_docs/docs/pgaa/1.7/reference/index.mdx
@@ -4,13 +4,13 @@ navTitle: Reference
 description: The reference section is a definitive listing of all functions, configuration parameters, table options, and data types available in Postgres Analytics Accelerator.
 deepToC: true
 redirects:
-- /edb-postgres-ai/preview/analytics/reference/
-- /edb-postgres-ai/preview/analytics/reference/delta_tables
-- /edb-postgres-ai/preview/analytics/reference/directscan
-- /edb-postgres-ai/preview/analytics/reference/instances
-- /edb-postgres-ai/preview/analytics/reference/loadingdata
-- /edb-postgres-ai/preview/analytics/reference/queries
-- /edb-postgres-ai/preview/analytics/reference/users
+- /edb-postgres-ai/latest/analytics/reference/
+- /edb-postgres-ai/latest/analytics/reference/delta_tables
+- /edb-postgres-ai/latest/analytics/reference/directscan
+- /edb-postgres-ai/latest/analytics/reference/instances
+- /edb-postgres-ai/latest/analytics/reference/loadingdata
+- /edb-postgres-ai/latest/analytics/reference/queries
+- /edb-postgres-ai/latest/analytics/reference/users
 navigation:
   - configuration_parameters
   - functions
