You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@polaris.apache.org by sn...@apache.org on 2026/05/02 18:00:31 UTC

(polaris) branch main updated: Site: update guides to latest stable docs (#4345)

This is an automated email from the ASF dual-hosted git repository.

snazy pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/polaris.git


The following commit(s) were added to refs/heads/main by this push:
     new 3d48c4ff34 Site: update guides to latest stable docs (#4345)
3d48c4ff34 is described below

commit 3d48c4ff34c79212daf423ad9a730657e819d00a
Author: Robert Stupp <sn...@snazy.de>
AuthorDate: Sat May 2 20:00:28 2026 +0200

    Site: update guides to latest stable docs (#4345)
    
    The guides under site/content/guides/ are public user-facing material.
    They should target the latest stable release, not the unreleased 'work in progress' state of main.
    That distinction matters on an ASF project site, where published guidance must track released behavior.
    
    This updates the guide links accordingly and removes the raw main-branch asset pointer from the guide layout.
    This guide work is isolated in its own PR because it requires the dedicated site/it verification.
---
 site/content/guides/keycloak/index.md   |  4 ++--
 site/content/guides/quickstart/index.md |  4 ++--
 site/layouts/guides/baseof.html         | 12 +++++++++---
 3 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/site/content/guides/keycloak/index.md b/site/content/guides/keycloak/index.md
index 5fb2422bcf..36fd895289 100644
--- a/site/content/guides/keycloak/index.md
+++ b/site/content/guides/keycloak/index.md
@@ -59,7 +59,7 @@ Polaris is configured with 3 realms:
   issued by both Polaris and Keycloak.
 
 For more information about how to configure Polaris with external authentication, see the
-[Polaris documentation](../../in-dev/unreleased).
+[Polaris documentation](/releases/latest/).
 
 ## Starting the Example
 
@@ -221,4 +221,4 @@ curl -v http://localhost:8181/api/management/v1/catalogs \
   -H 'Accept: application/json' || true
 ```
 
-This will return a `401 Unauthorized` error because the token is not valid for the `realm-internal` realm.
\ No newline at end of file
+This will return a `401 Unauthorized` error because the token is not valid for the `realm-internal` realm.
diff --git a/site/content/guides/quickstart/index.md b/site/content/guides/quickstart/index.md
index 5157698117..a94f49673f 100644
--- a/site/content/guides/quickstart/index.md
+++ b/site/content/guides/quickstart/index.md
@@ -28,11 +28,11 @@ menus:
         weight: 2
 ---
 
-Please see the [quickstart guide](../../in-dev/unreleased/getting-started) for more information.
+Please see the [quickstart guide](/releases/latest/getting-started/) for more information.
 
 <!--
 ```shell
 cd "$SITE_TEST_GUIDE_DIR"
 docker compose up
 ```
--->
\ No newline at end of file
+-->
diff --git a/site/layouts/guides/baseof.html b/site/layouts/guides/baseof.html
index 338d8a58ce..30690df1bc 100644
--- a/site/layouts/guides/baseof.html
+++ b/site/layouts/guides/baseof.html
@@ -44,12 +44,18 @@
             {{ if not .Site.Params.ui.breadcrumb_disable }}{{ partial "breadcrumb.html" . }}{{ end }}
             <h1>{{ .Title }}</h1>
             {{ $res := .Resources -}}
-            {{ $pageRelPermalink := .RelPermalink }}
             {{ if $res }}
               <div class="alert alert-primary">
                 <p class="alert-heading">
-                  ℹ️ Assets for this guide can be accessed from the <a href="https://github.com/apache/polaris/tree/main/site/content{{ $pageRelPermalink }}">Apache Polaris Git repository</a>
+                  ℹ️ Guide assets:
                 </p>
+                <ul class="mb-0">
+                  {{ range $res }}
+                    {{ if not (hasPrefix .Name ".") }}
+                      <li><a href="{{ .RelPermalink }}">{{ .Name }}</a></li>
+                    {{ end }}
+                  {{ end }}
+                </ul>
               </div>
             {{ end }}
             {{ block "main" . }}{{ end }}
@@ -60,4 +66,4 @@
     </div>
     {{ partial "scripts.html" . }}
   </body>
-</html>
\ No newline at end of file
+</html>