[Numpy-discussion] Dropping the pdf documentation.

2022-05-22 Thread Charles R Harris
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 . Chuck _

[Numpy-discussion] Re: Dropping the pdf documentation.

2022-05-22 Thread Stephan Hoyer
+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 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/

[Numpy-discussion] Re: Dropping the pdf documentation.

2022-05-22 Thread Rohit Goswami
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

[Numpy-discussion] Re: Dropping the pdf documentation.

2022-05-22 Thread Stephan Hoyer
On Sun, May 22, 2022 at 3:52 PM 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. > The HTML docs can also be downloaded for offline use. Perhaps som

[Numpy-discussion] Re: Dropping the pdf documentation.

2022-05-22 Thread Rohit Goswami
The HTML docs can also be downloaded for offline use. HTML documentation isn't easy to navigate on anything other than a laptop / tablet. It also makes it confusing when there isn't an internet connection because of the external links. Also it is hard (subjectively) to read in order. Also m

[Numpy-discussion] Re: Dropping the pdf documentation.

2022-05-22 Thread Charles R Harris
On Sun, May 22, 2022 at 4:54 PM 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-re

[Numpy-discussion] Re: Dropping the pdf documentation.

2022-05-22 Thread Matti Picus
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 trave

[Numpy-discussion] Re: Dropping the pdf documentation.

2022-05-22 Thread Ralf Gommers
On Mon, May 23, 2022 at 1:31 AM Stephan Hoyer wrote: > On Sun, May 22, 2022 at 3:52 PM 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. >> >

[Numpy-discussion] Re: Dropping the pdf documentation.

2022-05-22 Thread Ralf Gommers
On Mon, May 23, 2022 at 6:51 AM Matti Picus wrote: > > 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 persona