DOCS-2693 / 28 / DOCS-2693 Fix endless refresh on drafted KMIP and Community Tutorials URLs

.github/scripts/check_aliases.py

@@ -40,7 +40,12 @@
 
             if data is None:
                 continue
-            aliases = data.get("aliases", [])
+            aliases = data.get("aliases") or []
+            # Hugo still writes an alias stub for a draft page, but the stub has no
+            # target URL (<meta http-equiv="refresh" content="0; url=">), so browsers
+            # reload it forever. Draft pages must not declare aliases.
+            if data.get("draft") is True and aliases:
+                violations.append(f"{file}: draft page declares aliases, which produce an endless-refresh stub. Remove the aliases while the page is draft: {', '.join(aliases)}")
             for alias in aliases:
                 if version_pattern.search(alias) and not any(pattern.match(alias) for pattern in exception_patterns):
                     violations.append(f"{file}: contains forbidden alias: {alias}")
@@ -49,7 +54,7 @@
         print(f"⚠️ Error reading {file}: {e}")
 
 if violations:
-    print("\n🚫 Forbidden versioned aliases found:")
+    print("\n🚫 Forbidden aliases found:")
     for v in violations:
         print(v)
     sys.exit(1)

content/SCALE/CommunityRecommends/_index.md

@@ -3,8 +3,6 @@ title: "Community Tutorials"
 description: "Tutorials written by the open source TrueNAS Community about specific TrueNAS configurations and use cases."
 geekdocCollapseSection: true
 weight: 140
-aliases:
- - /scale/scaletutorials/communityrecommends/
 draft: true
 related: false
 ---

content/SCALE/Credentials/KMIP/ConfiguringKMIP.md

@@ -10,8 +10,6 @@ keywords:
 - nas storage 
 doctype: tutorial
 draft: true
-aliases:
- - /scale/scaletutorials/credentials/configuringkmipscale/
 ---
 
 

content/SCALE/Credentials/KMIP/KMIPScreen.md

@@ -2,9 +2,6 @@
 title: "KMIP Screen"
 description: "Describes the fields in the KMIP Key Status screen on TrueNAS Enterprise."
 weight: 50
-aliases:
- - /scale/scaleuireference/credentials/kmipscale/
- - /scale/scaleclireference/system/clikmip/
 tags:
 - kmip
 - enterprise

content/SCALE/Credentials/KMIP/_index.md

@@ -3,8 +3,6 @@ title: "KMIP"
 description: "Information on Key Management Interoperability Protocol (KMIP) configuration in TrueNAS Enterprise."
 geekdocCollapseSection: true
 weight: 90
-aliases:
- - /scale/credentials/kmip/
 draft: true
 related: false
 ---

content/SCALE/Credentials/_index.md

@@ -7,6 +7,12 @@ related: false
 aliases:
  - /scale/scaleuireference/credentials/
  - /scale/scaletutorials/credentials/
+ # KMIP is draft. Redirect its old URLs here so they do not 404.
+ # When KMIP leaves draft, move these four aliases back to the KMIP pages.
+ - /scale/credentials/kmip/
+ - /scale/scaletutorials/credentials/configuringkmipscale/
+ - /scale/scaleuireference/credentials/kmipscale/
+ - /scale/scaleclireference/system/clikmip/
 ---
 
 TrueNAS credential options are organized into screens to manage local users and groups, backup credentials (cloud and SSH), certificates, and directory services.

content/SCALE/_index.md

@@ -8,6 +8,9 @@ aliases:
  - /scale/scaletutorials/
  - /scale/scaleuireference/
  - /scale/scaleclireference/
+ # Community Tutorials is draft. Redirect its old URL here so it does not 404.
+ # When it leaves draft, move this alias back to content/SCALE/CommunityRecommends/_index.md.
+ - /scale/scaletutorials/communityrecommends/
 cascade:
   - _target:
     volume: "SCALE"