Show expected docs URL in workflow summary

- Add fixed expected GitHub Pages URL to Resolve Version summary
- Document expected docs URL and setup steps in README
- Sync quick-start and workflow guide with docs URL guidance

Made-with: Cursor

Author: Hongwei-MB

.github/workflows/ci.yml

@@ -108,6 +108,10 @@ jobs:
           fi
 
           MODE=$( [ "$IS_RELEASE" = "true" ] && echo "Release" || echo "CI" )
+          REPO="${{ github.repository }}"
+          OWNER="${REPO%%/*}"
+          REPO_NAME="${REPO##*/}"
+          DOCS_URL="https://${OWNER,,}.github.io/${REPO_NAME}/"
 
           {
             echo "## Version Info"
@@ -121,6 +125,8 @@ jobs:
             echo "| **Bump Type** | **$BUMP** |"
             echo "| **Mode** | $MODE |"
             echo "| **Commit** | \`${SHA::8}\` |"
+            echo "| **Expected Docs URL** | $DOCS_URL |"
+            echo "| **Docs Auto-Deploy** | Enable Pages (GitHub Actions) + add \`docs/docfx.json\` |"
           } >> "$GITHUB_STEP_SUMMARY"
 
       - name: Compute build matrix

README.md

@@ -151,6 +151,9 @@ To enable automatic documentation deployment to GitHub Pages:
 1. Add a `docs/docfx.json` configuration file
 2. Enable GitHub Pages in **Settings > Pages > Source: GitHub Actions**
 3. The `deploy-docs` job will automatically build and deploy after each release
+4. Expected docs URL: `https://<owner>.github.io/<repo>/` (for this repo: `https://agibuild.github.io/dotnet.CI.template/`)
+
+The `Resolve Version` job summary always shows this expected docs URL, even when docs deployment is skipped.
 
 ---
 

docs/github-workflows-guide.md

@@ -90,6 +90,8 @@ push / PR to main + weekly
 如果使用 DocFX 文档部署：
 - Settings → Pages → Source 选择 GitHub Actions
 - environment `github-pages` 会自动创建
+- 预期文档地址：`https://<owner>.github.io/<repo>/`（本仓库为 `https://agibuild.github.io/dotnet.CI.template/`）
+- `Resolve Version` 的 Summary 会固定显示该地址，便于快速访问
 
 ### Secrets
 - `NUGET_API_KEY`：NuGet.org API key（在 repo 或 `release` environment 级别配置）

docs/quick-start-release.md

@@ -45,6 +45,7 @@ resolve-version → build-and-test (matrix) → release (需 approve) → deploy
 - 一个新的 GitHub Release
 - Release 附件里有各平台安装包 zip（`app-linux-x64.zip`、`app-win-x64.zip` 等）
 - NuGet.org 上有对应版本的包（如已配置 `NUGET_API_KEY`）
+- 如果已启用 Pages + DocFX：文档地址 `https://agibuild.github.io/dotnet.CI.template/`
 
 ---