From 1e9859d9464dd0df14048498bee6d4554db4cb9a Mon Sep 17 00:00:00 2001 From: Glyph Date: Wed, 7 Sep 2022 15:14:12 -0700 Subject: [PATCH 1/3] re-enable htmlzip format (and any future formats) --- .readthedocs.yml | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/.readthedocs.yml b/.readthedocs.yml index 70095afbc08..03a057a2d34 100644 --- a/.readthedocs.yml +++ b/.readthedocs.yml @@ -8,9 +8,7 @@ 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 +formats: all python: version: 3.8 From 234ed8d868647354b6558d054a291bea8f437149 Mon Sep 17 00:00:00 2001 From: Glyph Date: Wed, 7 Sep 2022 15:15:06 -0700 Subject: [PATCH 2/3] topfile --- src/twisted/newsfragments/11645.misc | 0 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 src/twisted/newsfragments/11645.misc diff --git a/src/twisted/newsfragments/11645.misc b/src/twisted/newsfragments/11645.misc new file mode 100644 index 00000000000..e69de29bb2d From 5cd2a34971ad751a73284a8763f7b8cac2c07cad Mon Sep 17 00:00:00 2001 From: Glyph Date: Wed, 7 Sep 2022 15:24:08 -0700 Subject: [PATCH 3/3] verbiage --- .readthedocs.yml | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/.readthedocs.yml b/.readthedocs.yml index 03a057a2d34..2fb134bb1e9 100644 --- a/.readthedocs.yml +++ b/.readthedocs.yml @@ -8,6 +8,15 @@ sphinx: # This can be re-enable once RTD is updated with https://github.com/readthedocs/readthedocs.org/issues/7116 fail_on_warning: False +# 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: