diff --git a/XML-shaders.md b/XML-shaders.md
index d35c383..efe2b43 100644
--- a/XML-shaders.md
+++ b/XML-shaders.md
@@ -1,3 +1,6 @@
+# This documentation is deprecated
+**Please note that this documentation is only available for historical reference. Please visit https://buildbot.libretro.com/docs/ for current information on RetroArch shaders.**
+
 ## History
 XML shaders were originally implemented in bSNES as single pass GLSL shaders. The extension is .shader and is marked up with XML. These shaders were written against the fixed-function pipeline and is now referred to as a legacy XML shaders by RetroArch. The prefix of `ruby` originates from bSNES' driver module, `ruby::`.