diff --git a/README.md b/README.md
index 611cd703a..ff754e541 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,9 @@
 
 Say goodbye to messy service objects. CMDx helps you design business logic with clarity and consistency—build faster, debug easier, and ship with confidence.
 
+> [!NOTE]
+> Documentation reflects the latest code on `main`. For version-specific documentation, please refer to the `docs/` directory within that version's tag.
+
 ## Requirements
 
 - Ruby: MRI 3.1+ or JRuby 9.4+.
diff --git a/docs/index.md b/docs/index.md
index 42e54a1f6..d58edb5c4 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -6,8 +6,14 @@ Build business logic that's powerful, predictable, and maintainable.
 [![Build](https://github.com/drexed/cmdx/actions/workflows/ci.yml/badge.svg)](https://github.com/drexed/cmdx/actions/workflows/ci.yml)
 [![License](https://img.shields.io/github/license/drexed/cmdx)](https://github.com/drexed/cmdx/blob/main/LICENSE.txt)
 
+---
+
 Say goodbye to messy service objects. CMDx helps you design business logic with clarity and consistency—build faster, debug easier, and ship with confidence.
 
+!!! note
+
+    Documentation reflects the latest code on `main`. For version-specific documentation, please refer to the `docs/` directory within that version's tag.
+
 ## Installation
 
 ```sh