On 23/5/22 01:51, Rohit Goswami wrote:
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
Thanks Rohit for the offer to take on this project.
I don't think we should block the release on the existence of PDF
documentation. It is a "nice to have", not a hard requirement.
One strategy to discover problems with the PDF builds in CI would be to
add a weekly build of PDF.
Matti
_______________________________________________
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
