diff --git a/README.md b/README.md
index 86026d1..6bf9513 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,7 @@
+> [!WARNING]
+> You can now find the Alpaca documentation at [docs.alpaca.markets](https://docs.alpaca.markets/).
+> This repository is no longer used and is outdated.
+
 # alpaca-docs
 
 Developer documentation for Alpaca API's.
diff --git a/oas/README.md b/oas/README.md
index 6d6d168..5a99069 100644
--- a/oas/README.md
+++ b/oas/README.md
@@ -1,12 +1,10 @@
+> [!WARNING]
+> The OpenAPI specifications in this directory are outdated. Please find the up-to-date specifications [here](https://docs.alpaca.markets/openapi).
+
 # alpaca-oas
 
 Alpaca [OpenAPI specifcations (OAS)](https://swagger.io/docs/specification/about/).
 
----
-# ⚠️ These specs are still a work in progress and might not at this time accurately reflect the latest state of our apis. ⚠️
-
-We are currently working on making these specs accurate but currently some inaccuracies or missing endpoints are expected.
-
 ---
 ## Getting started