From f7652909f51d4ddaebe25d75d50f9d7995dbe6fc Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Thu, 24 Jul 2025 15:13:01 -0500
Subject: [PATCH 01/18] Update Makefile

---
 site/Makefile | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/site/Makefile b/site/Makefile
index ef66118ad5f7..f67397f9733a 100755
--- a/site/Makefile
+++ b/site/Makefile
@@ -15,12 +15,17 @@
 
 .PHONY: help
 help: # Show help for each of the Makefile recipes.
-	@grep -E '^[a-zA-Z0-9 -]+:.*#'  Makefile | sort | while read -r l; do printf "\033[1;32m$$(echo $$l | cut -f 1 -d':')\033[00m:$$(echo $$l | cut -f 2- -d'#')\n"; done
+	@grep -E '^[a-zA-Z0-9 -]+:.*#'  Makefile | sort | while read -r l; do printf "$$(echo $$l | cut -f 1 -d':'):$$(echo $$l | cut -f 2- -d'#')
+"; done
 
 .PHONY: serve
 serve: # Clean, build, and run the docs site locally.
 	dev/serve.sh
 
+.PHONY: serve-local
+serve-local: # Clean, build, and run the docs site locally using local docs.
+	dev/serve.sh --local
+
 .PHONY: build
 build: # Clean and build the docs site locally.
 	dev/build.sh

From 2ecf3676e59144872a9d0c352f051da839b72a60 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Thu, 24 Jul 2025 15:13:33 -0500
Subject: [PATCH 02/18] Update common.sh

---
 site/dev/common.sh | 32 +++++++++++++++++++++++++++-----
 1 file changed, 27 insertions(+), 5 deletions(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index fa409847600e..e70055844889 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -177,12 +177,12 @@ update_version () {
   # Update version information within the mkdocs.yml file using sed commands
   if [ "$(uname)" == "Darwin" ]
   then
-    /usr/bin/sed -i '' -E "s/(^site\_name:[[:space:]]+docs\/).*$/\1${ICEBERG_VERSION}/" ${ICEBERG_VERSION}/mkdocs.yml
-    /usr/bin/sed -i '' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" ${ICEBERG_VERSION}/mkdocs.yml
+    /usr/bin/sed -i '' -E "s/(^site\_name:[[:space:]]+docs\/).*$/
${ICEBERG_VERSION}/" ${ICEBERG_VERSION}/mkdocs.yml
+    /usr/bin/sed -i '' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/
${ICEBERG_VERSION}/" ${ICEBERG_VERSION}/mkdocs.yml
   elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]
   then
-    sed -i'' -E "s/(^site_name:[[:space:]]+docs\/)[^[:space:]]+/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
-    sed -i'' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
+    sed -i'' -E "s/(^site_name:[[:space:]]+docs\/)[^[:space:]]+/
${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
+    sed -i'' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/
${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
   fi
 
 }
@@ -201,7 +201,9 @@ search_exclude_versioned_docs () {
 
   # Modify .md files to exclude versioned documentation from search indexing
   python3 -c "import os
-for f in filter(lambda x: x.endswith('.md'), os.listdir()): lines = open(f).readlines(); open(f, 'w').writelines(lines[:2] + ['search:\n', '  exclude: true\n'] + lines[2:]);"
+for f in filter(lambda x: x.endswith('.md'), os.listdir()): lines = open(f).readlines(); open(f, 'w').writelines(lines[:2] + ['search:
+', '  exclude: true
+'] + lines[2:]);"
 
   cd -
 }
@@ -233,6 +235,26 @@ pull_versioned_docs () {
   create_nightly  
 }
 
+# Sets up local worktrees for the documentation and performs operations related to different versions.
+pull_local_docs () {
+  echo " --> pull local docs"
+
+  mkdir -p docs/docs
+  mkdir -p docs/javadoc
+
+  # Retrieve the latest version of documentation for processing
+  local latest_version=$(get_latest_version)
+
+  # Output the latest version for debugging purposes
+  echo "Latest version is: ${latest_version}"
+
+  # Create the 'latest' version of documentation
+  create_latest "${latest_version}"
+
+  # Create the 'nightly' version of documentation
+  create_nightly
+}
+
 # Cleans up artifacts and temporary files generated during documentation management.
 clean () {
   echo " --> clean"

From 1f457eb69d057fa079281395b6316eb23bb50671 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Thu, 24 Jul 2025 15:14:06 -0500
Subject: [PATCH 03/18] Update serve.sh

---
 site/dev/serve.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/site/dev/serve.sh b/site/dev/serve.sh
index 8901de92ab04..2d10359280a0 100755
--- a/site/dev/serve.sh
+++ b/site/dev/serve.sh
@@ -18,6 +18,6 @@
 
 set -e
 
-./dev/setup_env.sh
+./dev/setup_env.sh "$1"
 
 mkdocs serve --dirty --watch .

From 1e970cae3b909a7f2e06f851fa30d6a775fe8795 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Thu, 24 Jul 2025 15:14:34 -0500
Subject: [PATCH 04/18] Update setup_env.sh

---
 site/dev/setup_env.sh | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/site/dev/setup_env.sh b/site/dev/setup_env.sh
index f87c10d20d2e..991c04ef04af 100755
--- a/site/dev/setup_env.sh
+++ b/site/dev/setup_env.sh
@@ -24,6 +24,10 @@ clean
 
 install_deps
 
-pull_versioned_docs
+if [ "$1" == "--local" ]; then
+  pull_local_docs
+else
+  pull_versioned_docs
+fi
 
 git show "${REMOTE}/main:../.asf.yaml" > docs/.asf.yaml

From a9c7392ba364be7cb3a5916e7a3e501ec18c3b41 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Sat, 23 Aug 2025 18:03:15 -0500
Subject: [PATCH 05/18] [docs] Fix sed replacements in common.sh (remove stray
 control char, quote paths)

- Fixed sed replacements in site/dev/common.sh:
  * Restored correct \1 backreferences (removed stray ^A control chars).
  * Corrected `site_name` key (removed accidental escape).
  * Quoted mkdocs.yml paths for safety.
  * Made Darwin and Linux blocks consistent.

No functional change beyond correcting the replacements. This addresses
the reviewer comment on unexpected edits in common.sh.
---
 site/dev/common.sh | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index e70055844889..51400ea45c98 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -174,17 +174,18 @@ update_version () {
   # Ensure ICEBERG_VERSION is not empty
   assert_not_empty "${ICEBERG_VERSION}"  
 
-  # Update version information within the mkdocs.yml file using sed commands
-  if [ "$(uname)" == "Darwin" ]
+    # Update version information within the mkdocs.yml file using sed commands
+  if [ "$(uname)" = "Darwin" ]; 
   then
-    /usr/bin/sed -i '' -E "s/(^site\_name:[[:space:]]+docs\/).*$/
${ICEBERG_VERSION}/" ${ICEBERG_VERSION}/mkdocs.yml
-    /usr/bin/sed -i '' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/
${ICEBERG_VERSION}/" ${ICEBERG_VERSION}/mkdocs.yml
-  elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]
+    /usr/bin/sed -i '' -E "s/(^site_name:[[:space:]]+docs\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
+    /usr/bin/sed -i '' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
+  elif [ "$(expr substr "$(uname -s)" 1 5)" = "Linux" ]; 
   then
-    sed -i'' -E "s/(^site_name:[[:space:]]+docs\/)[^[:space:]]+/
${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
-    sed -i'' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/
${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
+    sed -i'' -E "s/(^site_name:[[:space:]]+docs\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
+    sed -i'' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
   fi
 
+
 }
 
 # Excludes versioned documentation from search indexing by modifying .md files.

From adc9de5dc48593e50102f106277408d1bb2b44bb Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Sat, 23 Aug 2025 18:05:56 -0500
Subject: [PATCH 06/18] removing unwanted new line characters

---
 site/dev/common.sh | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index 51400ea45c98..7a2dcd7b2a9b 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -202,9 +202,7 @@ search_exclude_versioned_docs () {
 
   # Modify .md files to exclude versioned documentation from search indexing
   python3 -c "import os
-for f in filter(lambda x: x.endswith('.md'), os.listdir()): lines = open(f).readlines(); open(f, 'w').writelines(lines[:2] + ['search:
-', '  exclude: true
-'] + lines[2:]);"
+for f in filter(lambda x: x.endswith('.md'), os.listdir()): lines = open(f).readlines(); open(f, 'w').writelines(lines[:2] + ['search:', '  exclude: true'] + lines[2:]);"
 
   cd -
 }

From 4c48c28e7b81ab42d358589c9a9082c5b0d1c839 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Sat, 23 Aug 2025 18:07:32 -0500
Subject: [PATCH 07/18] Update common.sh

---
 site/dev/common.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index 7a2dcd7b2a9b..17ca15037be4 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -202,7 +202,7 @@ search_exclude_versioned_docs () {
 
   # Modify .md files to exclude versioned documentation from search indexing
   python3 -c "import os
-for f in filter(lambda x: x.endswith('.md'), os.listdir()): lines = open(f).readlines(); open(f, 'w').writelines(lines[:2] + ['search:', '  exclude: true'] + lines[2:]);"
+for f in filter(lambda x: x.endswith('.md'), os.listdir()): lines = open(f).readlines(); open(f, 'w').writelines(lines[:2] + ['search:\n', '  exclude:\ntrue'] + lines[2:]);"
 
   cd -
 }

From e5c6a096bdf04dd597ddfa19c572cf2a3fc19cce Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Sat, 23 Aug 2025 18:08:54 -0500
Subject: [PATCH 08/18] Update common.sh

---
 site/dev/common.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index 17ca15037be4..d4dc5d4f90ba 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -202,7 +202,7 @@ search_exclude_versioned_docs () {
 
   # Modify .md files to exclude versioned documentation from search indexing
   python3 -c "import os
-for f in filter(lambda x: x.endswith('.md'), os.listdir()): lines = open(f).readlines(); open(f, 'w').writelines(lines[:2] + ['search:\n', '  exclude:\ntrue'] + lines[2:]);"
+for f in filter(lambda x: x.endswith('.md'), os.listdir()): lines = open(f).readlines(); open(f, 'w').writelines(lines[:2] + ['search:\n', '  exclude: true\n'] + lines[2:]);"
 
   cd -
 }

From f10a6877c5d0a7676aacae6b1ffa7644fb406850 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Sat, 23 Aug 2025 18:14:42 -0500
Subject: [PATCH 09/18] Update common.sh
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replying to comment, https://github.com/apache/iceberg/pull/13664/files#r2278265126:
That’s a good point: for the fast-path (--local) build, we don’t actually need to generate the latest version. Skipping it speeds things up. I’ll update the local path so it only creates (or symlinks) the nightly version, leaving the full latest creation only in normal builds.
---
 site/dev/common.sh | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index d4dc5d4f90ba..d4b0dd1d5832 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -236,21 +236,16 @@ pull_versioned_docs () {
 
 # Sets up local worktrees for the documentation and performs operations related to different versions.
 pull_local_docs () {
-  echo " --> pull local docs"
+  echo " --> pull local docs (fast local mode)"
 
   mkdir -p docs/docs
   mkdir -p docs/javadoc
 
   # Retrieve the latest version of documentation for processing
   local latest_version=$(get_latest_version)
-
-  # Output the latest version for debugging purposes
   echo "Latest version is: ${latest_version}"
 
-  # Create the 'latest' version of documentation
-  create_latest "${latest_version}"
-
-  # Create the 'nightly' version of documentation
+  # Only create the 'nightly' version in local mode, skip 'latest' for speed
   create_nightly
 }
 

From 052aae359fde985401f934a038733017a11a3d66 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Sat, 23 Aug 2025 18:31:20 -0500
Subject: [PATCH 10/18] Update Makefile

---
 site/Makefile | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/site/Makefile b/site/Makefile
index f67397f9733a..58c404e5421b 100755
--- a/site/Makefile
+++ b/site/Makefile
@@ -15,8 +15,7 @@
 
 .PHONY: help
 help: # Show help for each of the Makefile recipes.
-	@grep -E '^[a-zA-Z0-9 -]+:.*#'  Makefile | sort | while read -r l; do printf "$$(echo $$l | cut -f 1 -d':'):$$(echo $$l | cut -f 2- -d'#')
-"; done
+	@grep -E '^[a-zA-Z0-9 -]+:.*#' Makefile | sort | while read -r l; do printf "\033[1;32m$$(echo $$l | cut -f 1 -d':')\033[00m:$$(echo $$l | cut -f 2- -d'#')\n"; done
 
 .PHONY: serve
 serve: # Clean, build, and run the docs site locally.

From cfa2a13b1dec9a85efba01283f10699ec5f183ec Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Wed, 27 Aug 2025 21:11:46 -0500
Subject: [PATCH 11/18] Update Makefile

---
 site/Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/site/Makefile b/site/Makefile
index 58c404e5421b..e6d77368b349 100755
--- a/site/Makefile
+++ b/site/Makefile
@@ -15,7 +15,7 @@
 
 .PHONY: help
 help: # Show help for each of the Makefile recipes.
-	@grep -E '^[a-zA-Z0-9 -]+:.*#' Makefile | sort | while read -r l; do printf "\033[1;32m$$(echo $$l | cut -f 1 -d':')\033[00m:$$(echo $$l | cut -f 2- -d'#')\n"; done
+	@grep -E '^[a-zA-Z0-9 -]+:.*#'  Makefile | sort | while read -r l; do printf "\033[1;32m$$(echo $$l | cut -f 1 -d':')\033[00m:$$(echo $$l | cut -f 2- -d'#')\n"; done
 
 .PHONY: serve
 serve: # Clean, build, and run the docs site locally.

From d605619f8c3e083a7487564243d8d58b226e56db Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Wed, 27 Aug 2025 21:25:17 -0500
Subject: [PATCH 12/18] Update common.sh

---
 site/dev/common.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index d4b0dd1d5832..0edd99c6228e 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -174,7 +174,7 @@ update_version () {
   # Ensure ICEBERG_VERSION is not empty
   assert_not_empty "${ICEBERG_VERSION}"  
 
-    # Update version information within the mkdocs.yml file using sed commands
+  # Update version information within the mkdocs.yml file using sed commands
   if [ "$(uname)" = "Darwin" ]; 
   then
     /usr/bin/sed -i '' -E "s/(^site_name:[[:space:]]+docs\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"

From 7a0b1c5d5f760b20e8d8f0f3bd2dc077eb2d83b2 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Wed, 27 Aug 2025 21:25:42 -0500
Subject: [PATCH 13/18] Update common.sh

---
 site/dev/common.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index 0edd99c6228e..7e554a3ed190 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -175,7 +175,7 @@ update_version () {
   assert_not_empty "${ICEBERG_VERSION}"  
 
   # Update version information within the mkdocs.yml file using sed commands
-  if [ "$(uname)" = "Darwin" ]; 
+  if [ "$(uname)" == "Darwin" ]; 
   then
     /usr/bin/sed -i '' -E "s/(^site_name:[[:space:]]+docs\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
     /usr/bin/sed -i '' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"

From 3183216fdaad97078a19b5a5fcb398e1fd9fba6d Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Thu, 28 Aug 2025 09:47:32 -0500
Subject: [PATCH 14/18] Update common.sh

---
 site/dev/common.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index 7e554a3ed190..68de489830ed 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -175,7 +175,7 @@ update_version () {
   assert_not_empty "${ICEBERG_VERSION}"  
 
   # Update version information within the mkdocs.yml file using sed commands
-  if [ "$(uname)" == "Darwin" ]; 
+  if [ "$(uname)" == "Darwin" ] 
   then
     /usr/bin/sed -i '' -E "s/(^site_name:[[:space:]]+docs\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
     /usr/bin/sed -i '' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"

From 35792644109f328637eef1657a96ce78b5355167 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Thu, 28 Aug 2025 09:49:22 -0500
Subject: [PATCH 15/18] Update common.sh

---
 site/dev/common.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index 68de489830ed..3feb7cbdd7ee 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -175,7 +175,7 @@ update_version () {
   assert_not_empty "${ICEBERG_VERSION}"  
 
   # Update version information within the mkdocs.yml file using sed commands
-  if [ "$(uname)" == "Darwin" ] 
+  if [ "$(uname)" == "Darwin" ]
   then
     /usr/bin/sed -i '' -E "s/(^site_name:[[:space:]]+docs\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
     /usr/bin/sed -i '' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"

From 51c18cd08237052bb1bf01a8c06864afec776b45 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Fri, 29 Aug 2025 13:03:06 -0500
Subject: [PATCH 16/18] Update common.sh

Fix sed patterns in mkdocs.yml update script

- Keep Linux site_name pattern token-level ([^[:space:]]+) so only the
  version number is replaced, avoiding clobbering the rest of the line.
- Leave Darwin and Javadoc patterns unchanged (.*$) to match main.
- Add quotes around $(uname -s) for safety.

Keeps behavior consistent with main while addressing reviewer concern
with minimal changes.
---
 site/dev/common.sh | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index 3feb7cbdd7ee..6121ea485bcc 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -179,13 +179,12 @@ update_version () {
   then
     /usr/bin/sed -i '' -E "s/(^site_name:[[:space:]]+docs\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
     /usr/bin/sed -i '' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
-  elif [ "$(expr substr "$(uname -s)" 1 5)" = "Linux" ]; 
+  elif [ "$(expr substr "$(uname -s)" 1 5)" == "Linux" ] 
   then
-    sed -i'' -E "s/(^site_name:[[:space:]]+docs\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
+    sed -i'' -E "s/(^site_name:[[:space:]]+docs\/)[^[:space:]]+/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
     sed -i'' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
   fi
 
-
 }
 
 # Excludes versioned documentation from search indexing by modifying .md files.

From d52b8a97b86eff20789a8ec5912b381d6a8788c3 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Mon, 15 Sep 2025 22:36:16 -0500
Subject: [PATCH 17/18] Update common.sh

---
 site/dev/common.sh | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index 6121ea485bcc..b66a3f5cbc42 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -177,9 +177,9 @@ update_version () {
   # Update version information within the mkdocs.yml file using sed commands
   if [ "$(uname)" == "Darwin" ]
   then
-    /usr/bin/sed -i '' -E "s/(^site_name:[[:space:]]+docs\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
-    /usr/bin/sed -i '' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
-  elif [ "$(expr substr "$(uname -s)" 1 5)" == "Linux" ] 
+    /usr/bin/sed -i '' -E "s/(^site\_name:[[:space:]]+docs\/).*$/\1${ICEBERG_VERSION}/" ${ICEBERG_VERSION}/mkdocs.yml
+    /usr/bin/sed -i '' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" ${ICEBERG_VERSION}/mkdocs.yml
+  elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]
   then
     sed -i'' -E "s/(^site_name:[[:space:]]+docs\/)[^[:space:]]+/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
     sed -i'' -E "s/(^[[:space:]]*-[[:space:]]+Javadoc:.*\/javadoc\/).*$/\1${ICEBERG_VERSION}/" "${ICEBERG_VERSION}/mkdocs.yml"
@@ -187,6 +187,7 @@ update_version () {
 
 }
 
+
 # Excludes versioned documentation from search indexing by modifying .md files.
 # Arguments:
 #   $1: ICEBERG_VERSION - The version number of the documentation to exclude from search indexing.

From a889ebc1537f3f9c7b6223f29abe6218618e7ba8 Mon Sep 17 00:00:00 2001
From: Yeswanth Surampudi <117461015+yeswanth-s1th@users.noreply.github.com>
Date: Mon, 15 Sep 2025 22:37:07 -0500
Subject: [PATCH 18/18] Update common.sh
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

reverting this block to match main so the PR stays focused. I’ll open a separate PR for the small sed/quoting cleanups.
---
 site/dev/common.sh | 1 -
 1 file changed, 1 deletion(-)

diff --git a/site/dev/common.sh b/site/dev/common.sh
index b66a3f5cbc42..a7efd58bd6ae 100755
--- a/site/dev/common.sh
+++ b/site/dev/common.sh
@@ -187,7 +187,6 @@ update_version () {
 
 }
 
-
 # Excludes versioned documentation from search indexing by modifying .md files.
 # Arguments:
 #   $1: ICEBERG_VERSION - The version number of the documentation to exclude from search indexing.