diff --git a/docs/themes.rst b/docs/themes.rst
index 95af399a..aba1ed4b 100644
--- a/docs/themes.rst
+++ b/docs/themes.rst
@@ -60,7 +60,9 @@ output_file     The name of the file currently being generated. For
 articles        The list of articles, ordered descending by date
                 All the elements are `Article` objects, so you can
                 access their attributes (e.g. title, summary, author
-                etc.)
+                etc.). Sometimes this is shadowed (for instance in
+                the tags page). You will then find info about it
+                in the `all_articles` variable.
 dates           The same list of articles, but ordered by date,
                 ascending
 tags            A list of (tag, articles) tuples, containing all