diff --git a/docs/examples/azure/gitversion/setup/usage-examples.md b/docs/examples/azure/gitversion/setup/usage-examples.md
index f57ca4c..52c7fbd 100644
--- a/docs/examples/azure/gitversion/setup/usage-examples.md
+++ b/docs/examples/azure/gitversion/setup/usage-examples.md
@@ -31,6 +31,14 @@ preferLatestVersion:
 
 ## Usage examples
 
+In order for the gitversion to properly work you need to clone the repository with the entire history:
+
+```yaml
+steps:
+  - checkout: self
+    fetchDepth: 0
+```
+
 ### Example 1
 
 Install the latest GitVersion 5 version.
diff --git a/docs/examples/github/gitversion/setup/usage-examples.md b/docs/examples/github/gitversion/setup/usage-examples.md
index d3e31d1..7ed2f91 100644
--- a/docs/examples/github/gitversion/setup/usage-examples.md
+++ b/docs/examples/github/gitversion/setup/usage-examples.md
@@ -27,6 +27,17 @@ ignoreFailedSources:
 
 ## Usage examples
 
+In order for the gitversion to properly work you need to clone the repository with the entire history:
+
+```yaml
+steps:
+  -
+    name: Checkout
+    uses: actions/checkout@v3
+    with:
+      fetch-depth: 0
+```
+
 ### Example 1
 
 Install the latest GitVersion 5 version.