#11645 all rtd formats (#11646)

enable HTMLZip format again on ReadTheDocs
twisted · Sep 7, 2022 · 016f2bc · 016f2bc
2 parents 76bb1ae + 5cd2a34
commit 016f2bc
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 3 deletions.
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -8,9 +8,16 @@ sphinx:
   # This can be re-enable once RTD is updated with https://github.com/readthedocs/readthedocs.org/issues/7116
   fail_on_warning: False
 
-formats:
-  - pdf
-  - epub
+# We don't proofread all the output formats, and we don't know if anyone really
+# uses some of them.  Is anyone actually printing the docs out as a PDF?  If a
+# particular format is useful to someone let's let them download it.  If
+# dubiously-used formats start causing build errors that are difficult to debug
+# (i.e. PDF, EPub) feel free to disable them if necessary, but HTMLZip is an
+# offline archive of the actual docs website that everyone uses most frequently
+# and should be kept working; if it's breaking then probably something is wrong
+# with the website as well.
+
+formats: all
 
 python:
   version: 3.8

diff --git a/src/twisted/newsfragments/11645.misc b/src/twisted/newsfragments/11645.misc