diff --git a/README.md b/README.md
index 6d89d903d..5a181f670 100644
--- a/README.md
+++ b/README.md
@@ -131,6 +131,8 @@ libraryDependencies ++= Seq(
 )
 ```
 
+Note that the examples below are validated against the current sources of coursier. You may want to read the [documentation of the latest release](https://github.com/coursier/coursier/blob/v1.0.2/README.md#api) of coursier instead.
+
 Add an import for coursier,
 ```scala
 import coursier._
@@ -421,6 +423,8 @@ libraryDependencies ++= Seq(
 )
 ```
 
+Note that the examples below are validated against the current sources of coursier. You may want to read the [documentation of the latest release](https://github.com/coursier/coursier/blob/v1.0.2/README.md#api-1) of coursier instead.
+
 The first module, `"io.get-coursier" %% "coursier" % "1.0.1"`, mainly depends on
 `scalaz-core` (and only it, *not* `scalaz-concurrent` for example). It contains among others,
 definitions,
diff --git a/doc/readme/README.md b/doc/readme/README.md
index 212047653..056b0deb0 100644
--- a/doc/readme/README.md
+++ b/doc/readme/README.md
@@ -131,6 +131,8 @@ libraryDependencies ++= Seq(
 )
 ```
 
+Note that the examples below are validated against the current sources of coursier. You may want to read the [documentation of the latest release](https://github.com/coursier/coursier/blob/v1.0.2/README.md#api) of coursier instead.
+
 Add an import for coursier,
 ```scala
 import coursier._
@@ -450,6 +452,8 @@ libraryDependencies ++= Seq(
 )
 ```
 
+Note that the examples below are validated against the current sources of coursier. You may want to read the [documentation of the latest release](https://github.com/coursier/coursier/blob/v1.0.2/README.md#api-1) of coursier instead.
+
 The first module, `"io.get-coursier" %% "coursier" % "1.0.1"`, mainly depends on
 `scalaz-core` (and only it, *not* `scalaz-concurrent` for example). It contains among others,
 definitions,