diff --git a/README.md b/README.md
index 1cd5b72..553ea25 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # ZMK ARTSEY Implementation
 
-This repo contains the ZMK ARTSEY implementation and pre-built firmware for boards that have been setup to use ARTSEY by the core ARTSEY development team.
+This repo contains the [ZMK](https://zmkfirmware.dev/) ARTSEY implementation and pre-built firmware for boards that have been setup to use ARTSEY by the core ARTSEY development team.
 
 ## Prebuilt Firmware
 
diff --git a/config/boards/shields/README.md b/config/boards/shields/README.md
new file mode 100644
index 0000000..600eb1f
--- /dev/null
+++ b/config/boards/shields/README.md
@@ -0,0 +1,3 @@
+# shields
+
+This directory contains the specific ZMK ARTSEY impementations for various keyboards. Please see the sub directories for specific implementation details.