Re: [sage-devel] documentation of SageMath (Python) packages

2019-01-29 Thread E. Madison Bray
On Tue, Jan 29, 2019 at 4:48 PM Thierry wrote: > > Hi, > > On Tue, Jan 29, 2019 at 09:32:58AM +0100, Vincent Delecroix wrote: > > Dear all, > > > > Imagine I have a Python module, typically hosted on PyPI and depending > > on SageMath, that provides documentation in some form (e.g. a pdf file, > >

Re: [sage-devel] documentation of SageMath (Python) packages

2019-01-29 Thread Thierry
Hi, On Tue, Jan 29, 2019 at 09:32:58AM +0100, Vincent Delecroix wrote: > Dear all, > > Imagine I have a Python module, typically hosted on PyPI and depending > on SageMath, that provides documentation in some form (e.g. a pdf file, > a sphinx repo, etc). > > 1) When a user performs `sage -pip in

Re: [sage-devel] documentation of SageMath (Python) packages

2019-01-29 Thread Vincent Delecroix
Le 29/01/2019 à 10:50, Dima Pasechnik a écrit : On Tue, Jan 29, 2019 at 8:40 AM Jeroen Demeyer wrote: On 2019-01-29 09:32, Vincent Delecroix wrote: 1) When a user performs `sage -pip install X`, should the documentation be compiled and installed? I'm pretty sure that the answer is "no

Re: [sage-devel] documentation of SageMath (Python) packages

2019-01-29 Thread Dima Pasechnik
On Tue, Jan 29, 2019 at 8:40 AM Jeroen Demeyer wrote: > > On 2019-01-29 09:32, Vincent Delecroix wrote: > > 1) When a user performs `sage -pip install X`, should the documentation > > be compiled and installed? > > I'm pretty sure that the answer is "no" for most Python packages. I see > two

Re: [sage-devel] documentation of SageMath (Python) packages

2019-01-29 Thread Vincent Delecroix
Le 29/01/2019 à 09:40, Jeroen Demeyer a écrit : On 2019-01-29 09:32, Vincent Delecroix wrote: 1) When a user performs `sage -pip install X`, should the documentation be compiled and installed? I'm pretty sure that the answer is "no" for most Python packages. The user might want to insta

Re: [sage-devel] documentation of SageMath (Python) packages

2019-01-29 Thread Jeroen Demeyer
On 2019-01-29 09:32, Vincent Delecroix wrote: 1) When a user performs `sage -pip install X`, should the documentation be compiled and installed? I'm pretty sure that the answer is "no" for most Python packages. I see two reasons for this: - there is no easy and obvious way to integrate

[sage-devel] documentation of SageMath (Python) packages

2019-01-29 Thread Vincent Delecroix
Dear all, Imagine I have a Python module, typically hosted on PyPI and depending on SageMath, that provides documentation in some form (e.g. a pdf file, a sphinx repo, etc). 1) When a user performs `sage -pip install X`, should the documentation be compiled and installed? If the answer is ye