doc-base and examples?

2018-05-28 Thread Diane Trout
Hi, I was wondering if one should be able to register examples (as source code) with doc-base? I.e. I was packaging a python package with sphinx documentation and have: /usr/share/doc/-doc/html (contains all the html source) /usr/share/doc/-doc/examples (contains .py example files) But I don't

Re: doc-base and examples?

2018-05-28 Thread Diane Trout
> I would not register example code in my packages with doc-base. As I > understand it, doc-base is merely intended to be used to register > more > traditional documentation: manuals, faqs, reference documentation, > etc. And in > .html, .pdf, etc. That's the way that doc-base currently works.

Re: doc-base and examples?

2018-05-28 Thread Joost van Baal-Ilić
Hi Diane, On Mon, May 28, 2018 at 09:20:50AM -0700, Diane Trout wrote: > > I was wondering if one should be able to register examples (as source > code) with doc-base? > > I.e. I was packaging a python package with sphinx documentation and > have: > > /usr/share/doc/-doc/html (contains all the

Re: doc-base and examples?

2018-05-28 Thread Joost van Baal-Ilić
On Mon, May 28, 2018 at 09:53:32PM -0700, Diane Trout wrote: > > > I would not register example code in my packages with doc-base. As I > > understand it, doc-base is merely intended to be used to register > > more > > traditional documentation: manuals, faqs, reference documentation, > > etc. A