diff --git a/docs/river/index.asciidoc b/docs/river/index.asciidoc
index 52716393bf0..6ccbbb9d449 100644
--- a/docs/river/index.asciidoc
+++ b/docs/river/index.asciidoc
@@ -1,4 +1,6 @@
 [[river]]
 = Rivers
 
-Rivers were deprecated in Elasticsearch 1.5 and removed in Elasticsearch 2.0.
\ No newline at end of file
+Rivers were deprecated in Elasticsearch 1.5 and removed in Elasticsearch 2.0.
+
+See https://www.elastic.co/blog/deprecating_rivers for more details.
\ No newline at end of file