From eeedf098436c1f78574993391e1b959513b4a7ed Mon Sep 17 00:00:00 2001
From: Jonathan Visser <jonathan.visser@team.blue>
Date: Mon, 29 Sep 2025 12:43:58 +0200
Subject: [PATCH 1/3] Add document How to set up a persistent external symlink
 on deployment

---
 ...rsistent-external-symlink-on-deployment.md | 47 +++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 docs/hypernode-deploy/getting-started/set-up-a-persistent-external-symlink-on-deployment.md

diff --git a/docs/hypernode-deploy/getting-started/set-up-a-persistent-external-symlink-on-deployment.md b/docs/hypernode-deploy/getting-started/set-up-a-persistent-external-symlink-on-deployment.md
new file mode 100644
index 00000000..861f48c7
--- /dev/null
+++ b/docs/hypernode-deploy/getting-started/set-up-a-persistent-external-symlink-on-deployment.md
@@ -0,0 +1,47 @@
+---
+myst:
+  html_meta:
+    description: Create a persistent external symlink in Hypernode Deploy that survives
+      releases and rollbacks.
+    title: How to set up a persistent external symlink on deployment
+---
+
+# Set up a persistent external symlink on deployment
+
+Sometimes it's important to have a persistent symlink that leads to a folder outside of your application, for example a subfolder blog, or external sitemaps.
+
+This pattern is useful when you want to expose content that lives outside the current release directory, while keeping it available and stable across deployments and rollbacks. By registering the path as a "shared file" in Hypernode Deploy, the final path in each release becomes a symlink to the shared area, which you can then point to any external location you need.
+
+## Install the Hypernode Deploy configuration package
+
+Make sure you have Hypernode Deploy set up and configured. If you haven't done this yet, follow the guide in [Install and configure Hypernode Deploy](install-and-configure-hypernode-deploy.md).
+
+## Steps
+
+1. Add the path that should become a symlink to the shared files configuration in your deploy.php config:
+
+```php
+$configuration->setSharedFiles([
+    'pub/my-symlink'
+]);
+```
+
+2. Deploy once. This will create the file at `~/apps/<appname>/shared/pub/my-symlink`.
+
+1. Replace the created file with a symlink to your external target. For example:
+
+```bash
+ln -s ~/blog ~/apps/<appname>/shared/pub/my-symlink
+```
+
+4. Deploy again. The symlink will be available in each new release and will persist across deployments.
+
+## Verify
+
+After deployment, verify the symlink inside the current release:
+
+```bash
+ls -l ~/apps/<appname>/current/pub/my-symlink
+```
+
+You should see it pointing to your external target (e.g., `~/blog`). If you open the URL that maps to `pub/my-symlink` in your site, the content should load from the external path.

From 0036285abd59190a244a13c1056eeef59b44b398 Mon Sep 17 00:00:00 2001
From: Jonathan Visser <jonathan.visser@team.blue>
Date: Mon, 29 Sep 2025 12:47:54 +0200
Subject: [PATCH 2/3] Add table of contents through blob for
 hypernode-deploy/getting-started

---
 docs/hypernode-deploy/getting-started.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/hypernode-deploy/getting-started.md b/docs/hypernode-deploy/getting-started.md
index 29dfaaf2..d6f0ff5d 100644
--- a/docs/hypernode-deploy/getting-started.md
+++ b/docs/hypernode-deploy/getting-started.md
@@ -13,7 +13,5 @@ myst:
 caption: Chapters
 maxdepth: 1
 ---
-getting-started/install-and-configure-hypernode-deploy.md
-getting-started/configure-ci-cd.md
-getting-started/configure-hypernode-settings-on-deployment.md
+getting-started/*
 ```

From 96cd4d2850ce97d4fd9a0ad03ac38b34e4d50887 Mon Sep 17 00:00:00 2001
From: Jonathan Visser <jonathan.visser@team.blue>
Date: Mon, 29 Sep 2025 12:50:14 +0200
Subject: [PATCH 3/3] Add glob field to use globs for getting-started in
 hypernode-deploy

---
 docs/hypernode-deploy/getting-started.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/hypernode-deploy/getting-started.md b/docs/hypernode-deploy/getting-started.md
index d6f0ff5d..d351f29c 100644
--- a/docs/hypernode-deploy/getting-started.md
+++ b/docs/hypernode-deploy/getting-started.md
@@ -12,6 +12,7 @@ myst:
 ---
 caption: Chapters
 maxdepth: 1
+glob:
 ---
 getting-started/*
 ```