Being very hard to read should not be reason enough to stop generating
them. In places with little to no internet connectivity often the PDF
documentation is invaluable.
I personally use the PDF documentation both on my phone and e-reader
when I travel simply because it is more accessible and has better search
capabilities.
It is true that SciPy has removed them, but that doesn't necessarily
mean we need to follow suit. Especially relevant (IMO) is that large
parts of the NumPy documentation still make sense when read sequentially
(going back to when it was at some point partially kanged from Travis'
book).
I'd be happy to spend time (and plan to) working on fixing concrete
issues other than straw-man and subjective arguments.
Personally I'd like to see the NumPy documentation have PDFs in a
fashion where each page / chapter can be downloaded individually.
-- Rohit
P.S.: If we have CI timeout issues, for the PDF docs we could also have
a dedicated repo and only build for releases.
P.P.S: FWIW the Python docs are also still distributed in PDF form.
On 22 May 2022, at 21:41, Stephan Hoyer wrote:
+1 let’s drop the PDF docs. They are already very hard to read.
On Sun, May 22, 2022 at 1:06 PM Charles R Harris
<charlesr.har...@gmail.com>
wrote:
Hi All,
This is a proposal to drop the generation of pdf documentation and
only
generate the html version. This is a one way change due to the
difficulty
maintaining/fixing the pdf versions. See minimal discussion here
<https://github.com/numpy/numpy/issues/21557#issuecomment-1133920412>
.
Chuck
_______________________________________________
NumPy-Discussion mailing list -- numpy-discussion@python.org
To unsubscribe send an email to numpy-discussion-le...@python.org
https://mail.python.org/mailman3/lists/numpy-discussion.python.org/
Member address: sho...@gmail.com
_______________________________________________
NumPy-Discussion mailing list -- numpy-discussion@python.org
To unsubscribe send an email to numpy-discussion-le...@python.org
https://mail.python.org/mailman3/lists/numpy-discussion.python.org/
Member address: rgosw...@quansight.com
_______________________________________________
NumPy-Discussion mailing list -- numpy-discussion@python.org
To unsubscribe send an email to numpy-discussion-le...@python.org
https://mail.python.org/mailman3/lists/numpy-discussion.python.org/
Member address: arch...@mail-archive.com