From f82a1a5e38f2d26b4599845c5fb86df62b0afa39 Mon Sep 17 00:00:00 2001
From: Aron Kerekes <arkereke@cisco.com>
Date: Tue, 28 Jul 2026 12:35:04 +0200
Subject: [PATCH] chore: linking shadi docs

Signed-off-by: Aron Kerekes <arkereke@cisco.com>
---
 docs/.index                  |  1 +
 docs/index.md                | 16 +++++++-------
 docs/stylesheets/custom.css  | 18 ++++++++++++++++
 docs/stylesheets/landing.css | 41 ++++++++++++++++++++++++++++++++++++
 mkdocs/mkdocs.yml            |  1 +
 5 files changed, 69 insertions(+), 8 deletions(-)

diff --git a/docs/.index b/docs/.index
index ba8a8fb..12c8dd9 100644
--- a/docs/.index
+++ b/docs/.index
@@ -4,6 +4,7 @@ nav:
   - Agent Directory Service: https://dir.agntcy.org/latest/
   - Secure Low-Latency Interactive Messaging (SLIM): https://slim.agntcy.org/latest/
   - Identity: https://spec.identity.agntcy.org/docs/intro
+  - SHADI: https://shadi.agntcy.org/
   - Observability and Evaluation: obs-and-eval
   - CSIT: csit
   - Getting Started: coffee-agntcy
diff --git a/docs/index.md b/docs/index.md
index f4978b9..edaba4e 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -82,6 +82,14 @@ hide:
 
     [:octicons-arrow-right-24: Identity overview]([[ agntcy.identity_url ]])
 
+- :material-shield-home-outline:{ .lg .middle } **SHADI**
+
+    ---
+
+    Secure Host for Agentic AI Dynamic Instantiation — a hardened runtime with verified identity, gated secrets, OS sandboxing, and encrypted local memory.
+
+    [:octicons-arrow-right-24: SHADI docs]([[ agntcy.shadi_url ]])
+
 - :material-chart-line:{ .lg .middle } **Observability and Evaluation**
 
     ---
@@ -106,14 +114,6 @@ hide:
 
     [:octicons-arrow-right-24: Get started](coffee-agntcy/get-started.md)
 
-- :material-book-open-page-variant-outline:{ .lg .middle } **Glossary**
-
-    ---
-
-    Definitions for terms used across AGNTCY documentation.
-
-    [:octicons-arrow-right-24: Glossary](glossary.md)
-
 - :material-hand-heart-outline:{ .lg .middle } **How to Contribute**
 
     ---
diff --git a/docs/stylesheets/custom.css b/docs/stylesheets/custom.css
index 5101bdc..eb4bece 100644
--- a/docs/stylesheets/custom.css
+++ b/docs/stylesheets/custom.css
@@ -145,6 +145,24 @@ html [data-md-color-primary=black] .md-nav--primary .md-nav__title[for=__drawer]
   background-color: rgb(12, 31, 54);
 }
 
+/* External site links in the primary nav — external-link indicator */
+.md-nav--primary .md-nav__link[href^="http"]::after {
+  content: "↗";
+  flex-shrink: 0;
+  align-self: center;
+  margin-inline-start: auto;
+  padding-inline-start: 0.25rem;
+  font-size: 0.8em;
+  line-height: 1;
+  opacity: 0.55;
+  transition: opacity 125ms;
+}
+
+.md-nav--primary .md-nav__link[href^="http"]:hover::after,
+.md-nav--primary .md-nav__link[href^="http"]:focus-visible::after {
+  opacity: 0.85;
+}
+
 .md-nav__title {
   font-size: 0 !important;
 }
diff --git a/docs/stylesheets/landing.css b/docs/stylesheets/landing.css
index 6058f69..cbce538 100644
--- a/docs/stylesheets/landing.css
+++ b/docs/stylesheets/landing.css
@@ -351,6 +351,35 @@ body:has(.agntcy-landing) .md-footer nav.md-footer__inner {
   height: 1em;
 }
 
+/* External doc cards — ↗ instead of in-site arrow */
+.md-typeset .agntcy-resources .grid.cards > ul > li > p:last-child a[href^="http"] .twemoji {
+  display: none;
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li > p:last-child a[href^="http"]::after {
+  content: "↗";
+  font-size: 0.85em;
+  line-height: 1;
+  opacity: 0.75;
+}
+
+.md-typeset
+  .agntcy-resources
+  .grid.cards
+  > ul
+  > li
+  > p:last-child
+  a[href^="http"]:hover::after,
+.md-typeset
+  .agntcy-resources
+  .grid.cards
+  > ul
+  > li
+  > p:last-child
+  a[href^="http"]:focus-visible::after {
+  opacity: 1;
+}
+
 /* ----------------------------------------------------------------------------
    Connect with AGNTCY
 ---------------------------------------------------------------------------- */
@@ -408,3 +437,15 @@ body:has(.agntcy-landing) .md-footer nav.md-footer__inner {
   height: 1rem;
   flex-shrink: 0;
 }
+
+.md-typeset .agntcy-connect__link::after {
+  content: "↗";
+  font-size: 0.8em;
+  line-height: 1;
+  opacity: 0.65;
+}
+
+.md-typeset .agntcy-connect__link:hover::after,
+.md-typeset .agntcy-connect__link:focus-visible::after {
+  opacity: 0.9;
+}
diff --git a/mkdocs/mkdocs.yml b/mkdocs/mkdocs.yml
index a5ec125..14f04e7 100644
--- a/mkdocs/mkdocs.yml
+++ b/mkdocs/mkdocs.yml
@@ -12,6 +12,7 @@ extra:
     dir_url: https://dir.agntcy.org/latest/
     slim_url: https://slim.agntcy.org/latest/
     identity_url: https://spec.identity.agntcy.org/docs/intro
+    shadi_url: https://shadi.agntcy.org/
   copyright: "© 2026, Agntcy, a Series of LF Projects, LLC. All rights reserved."
   analytics:
     provider: google