diff --git a/templates/MANIFEST.in b/templates/MANIFEST.in
index 87a12b7..e08086f 100644
--- a/templates/MANIFEST.in
+++ b/templates/MANIFEST.in
@@ -25,17 +25,6 @@ recursive-include src *.py
     #         - also possibly non-python, e.g. *.pyx for Cython
 
 
-#---------
-# SECTION: docs
-prune docs
-# and if required ... include ONLY docs source files.
-# E.G. recursive-include docs *.rst *.inc
-    # principles:
-    #    - use prune to ignore everything (optionally: except the docs sources)
-    # hints:
-    #    - most projects don't want to package the docs, but some currently do (cf-units).
-
-
 #---------
 # SECTION: requirements
 prune requirements
@@ -45,7 +34,6 @@ recursive-include requirements *.txt
     # hints:
     #    - not all projects include requirements, but they can be drawn in anyway by dynamic dependencies
     #        in the setuptools build process, linked via config in pyproject.toml
-    #    - for some repos, the *.txt are actually lockfiles.  This probably needs fixing.
 
 
 #---------
@@ -87,6 +75,7 @@ prune .github
 prune .nox
 prune .tox
 prune .coverage
+prune docs
 # (2) top-level files to omit
 exclude .coveragerc
 # (3) file types (path patterns) to skip everywhere