fix: support only report the url in pr change && fix _en.rst's url (#7528)

---------

Co-authored-by: Nyakku Shigure <[email protected]>

Author: ooooo-create

ci_scripts/report_preview_url.sh

@@ -11,12 +11,26 @@ generate_preview_url() {
     local file_path="$1"
     local pr_id="$2"
     local path_no_ext="${file_path%.*}"
-    local base_url="http://preview-pr-${pr_id}.paddle-docs-preview.paddlepaddle.org.cn/documentation/docs/zh/"
+
+    # Check if file ends with _en (English version)
+    # _en.rst will only reach English preview, _en.md can be reached in both English and Chinese previews
+    # To Simplify, we treat all _en files as English version
+    if [[ "$path_no_ext" == *_en ]]; then
+        local base_url="http://preview-pr-${pr_id}.paddle-docs-preview.paddlepaddle.org.cn/documentation/docs/en/"
+    else
+        # Use /zh/ path for Chinese version
+        local base_url="http://preview-pr-${pr_id}.paddle-docs-preview.paddlepaddle.org.cn/documentation/docs/zh/"
+    fi
+
     local final_url="${base_url}${path_no_ext}.html"
     echo "$final_url"
 }
 
-mapfile -t all_git_files < <(git diff --name-only --diff-filter=ACMR develop | sed 's#^docs/##')
+# Use merge-base to find the common ancestor between PR branch and develop
+# This ensures we only get changes from this PR, excluding commits merged to develop after PR creation
+BASE_COMMIT=$(git merge-base HEAD develop 2>/dev/null || echo "develop")
+
+mapfile -t all_git_files < <(git diff --name-only --diff-filter=ACMR "$BASE_COMMIT" | sed 's#^docs/##')
 
 output_lines=()
 
@@ -31,9 +45,16 @@ done
 if [ ${#output_lines[@]} -gt 0 ]; then
     cat <<-EOF
 <details>
-<summary>📚 本次 PR 文档预览链接 (点击展开)</summary>
-
-以下是本次 PR 中变更文档的预览链接：
+<summary>📚 本次 PR 文档预览链接（点击展开）</summary>
+
+<table>
+<tr>
+<td>
+ℹ️ <b>预览提醒</b><br>
+请等待 <code>Docs-NEW</code> 流水线运行完成后再点击预览链接，否则可能会看到旧版本内容或遇到链接无法访问的情况。
+</td>
+</tr>
+</table>
 
 $(printf '%s\n' "${output_lines[@]}")
 

docs/guides/flags/cudnn_en.rst

@@ -7,7 +7,7 @@ FLAGS_conv_workspace_size_limit
 *******************************************
 (since 0.13.0)
 
-The workspace limit size in MB unit for choosing cuDNN convolution algorithms. The inner funciton of cuDNN obtain the fastest suited algorithm that fits within this memory limit. Usually, large workspace size may lead to choose faster algorithms, but significant increasing memory workspace. Users need to trade-off between memory and speed.
+The workspace limit size in MB unit for choosing cuDNN convolution algorithms. The inner function of cuDNN obtain the fastest suited algorithm that fits within this memory limit. Usually, large workspace size may lead to choose faster algorithms, but significant increasing memory workspace. Users need to trade-off between memory and speed.
 
 Values accepted
 ---------------
@@ -60,7 +60,7 @@ FLAGS_cudnn_exhaustive_search
 *******************************************
 (since 1.2.0)
 
-Whether to use exhaustive search method to choose convolution algorithms. There are two search methods, heuristic search and exhaustive search in cuDNN. The exhaustive search attempts all cuDNN algorithms to choose the fastest algorithm. This method is time-consuming, the choosed algorithm will be cached for the given layer specifications. Once the layer specifications (like batch size, feature map size) are changed, it will search again.
+Whether to use exhaustive search method to choose convolution algorithms. There are two search methods, heuristic search and exhaustive search in cuDNN. The exhaustive search attempts all cuDNN algorithms to choose the fastest algorithm. This method is time-consuming, the chosen algorithm will be cached for the given layer specifications. Once the layer specifications (like batch size, feature map size) are changed, it will search again.
 
 Values accepted
 ---------------

docs/guides/performance_improving/profiling_model.md

@@ -575,7 +575,7 @@ Time Unit: s, IPS Unit: steps/s
 
 ### 3.3 Benchmark 信息展示
 
-Benckmark 信息用于展示模型的吞吐量以及时间开销。
+Benchmark 信息用于展示模型的吞吐量以及时间开销。
 
 ```plain
 ============================================Perf Summary============================================