From 8f6e7c580895d270722157469555fd8be945d91d Mon Sep 17 00:00:00 2001
From: Tom Gosling <Tom.gosling@genesis.global>
Date: Fri, 10 May 2024 16:45:41 +0100
Subject: [PATCH] Added small article on GPAL script resolution

---
 .../{00_classpaths.mdx => classpaths.mdx}     |  0
 .../script-resolution.mdx                     | 21 +++++++++++++++++++
 2 files changed, 21 insertions(+)
 rename docs/01_getting-started/05_advanced-learning/server-runtime-environment/{00_classpaths.mdx => classpaths.mdx} (100%)
 create mode 100644 docs/01_getting-started/05_advanced-learning/server-runtime-environment/script-resolution.mdx

diff --git a/docs/01_getting-started/05_advanced-learning/server-runtime-environment/00_classpaths.mdx b/docs/01_getting-started/05_advanced-learning/server-runtime-environment/classpaths.mdx
similarity index 100%
rename from docs/01_getting-started/05_advanced-learning/server-runtime-environment/00_classpaths.mdx
rename to docs/01_getting-started/05_advanced-learning/server-runtime-environment/classpaths.mdx
diff --git a/docs/01_getting-started/05_advanced-learning/server-runtime-environment/script-resolution.mdx b/docs/01_getting-started/05_advanced-learning/server-runtime-environment/script-resolution.mdx
new file mode 100644
index 0000000000..3c91997929
--- /dev/null
+++ b/docs/01_getting-started/05_advanced-learning/server-runtime-environment/script-resolution.mdx
@@ -0,0 +1,21 @@
+---
+id: script-resolution
+title: GPAL Script Resolution
+sidebar_label: GPAL Script Resolution
+sidebar_position: 2
+---
+# GPAL Script Resolution
+
+## Introduction
+This article is a brief explanation of how a genesis process locates GPAL script files when you add them to the `<script>` block of a process definition.
+
+GPAL scripts can be resolved from one of three locations:
+
+### Installed Modules
+The primary lookup location for GPAL scripts is in the `/scripts` directory in each installed module on the target server. That is, for every directory under `$GENESIS_HOME`, the process bootstrap will attempt to resolve a script file in `$GENESIS_HOME/<module>/scripts`.
+
+### Site Specific Scripts
+It is possible to override GPAL scripts that are installed as part of either the core platform or additional platform components by creating a file with the same name, or copying the file from the installed module, to the `site-specific/scripts` directory. Any script files in the `site-specific/scripts` directory will take precedence over files with the same name in the directory of an installed module.
+
+### Runtime Classpath
+GPAL script files can also be bundled inside jar archives. A script file can be resolved by name provided the file is in the root directory of a jar archive that has been added to the process classpath. This is useful if you do not want to allow overrides of specific script files for security reasons.
\ No newline at end of file