diff --git a/docs/settings.rst b/docs/settings.rst
index df093c60..a10010d7 100644
--- a/docs/settings.rst
+++ b/docs/settings.rst
@@ -728,12 +728,12 @@ Template pages
 
    The extensions to use when looking up template files from template names.
 
-.. data:: DIRECT_TEMPLATES = ['index', 'tags', 'categories', 'authors', 'archives']
+.. data:: DIRECT_TEMPLATES = ['index', 'authors', 'categories', 'tags', 'archives']
 
    List of templates that are used directly to render content. Typically direct
    templates are used to generate index pages for collections of content (e.g.,
-   tags and category index pages). If the tag and category collections are not
-   needed, set ``DIRECT_TEMPLATES = ['index', 'authors', 'archives']``
+   category and tag index pages). If the author, category and tag collections are not
+   needed, set ``DIRECT_TEMPLATES = ['index', 'archives']``
 
    ``DIRECT_TEMPLATES`` are searched for over paths maintained in
    ``THEME_TEMPLATES_OVERRIDES``.
diff --git a/docs/themes.rst b/docs/themes.rst
index adc7ec65..e0854646 100644
--- a/docs/themes.rst
+++ b/docs/themes.rst
@@ -82,11 +82,11 @@ dates           The same list of articles, but ordered by date,
                 ascending.
 drafts          The list of draft articles
 authors         A list of (author, articles) tuples, containing all
-                the authors.
+                the authors and corresponding articles (values)
 categories      A list of (category, articles) tuples, containing
                 all the categories and corresponding articles (values)
 tags            A list of (tag, articles) tuples, containing all
-                the tags.
+                the tags and corresponding articles (values)
 pages           The list of pages
 hidden_pages    The list of hidden pages
 draft_pages     The list of draft pages