[sage-devel] Re: Sphinx TODO extension

2011-07-03 Thread leif
On Monday, April 25, 2011 9:22:01 PM UTC+2, John H Palmieri wrote: > > > > On Monday, April 25, 2011 10:04:04 AM UTC-7, fhivert wrote: >> >> Hi there, >> >> I'm working on #9128 whose goal is to resolve dangling links by looking in >> python docs and in sage.all. On the way, I noticed that t

Re: [sage-devel] Re: Sphinx TODO extension

2011-04-27 Thread Pablo De Napoli
Please review ticket #10620 to upgrade sphynix Pablo On Mon, Apr 25, 2011 at 11:23 PM, Keshav Kini wrote: > I also prefer trac, but I know why: it's shorter! Also it's more clearly > related to trac.sagemath.org/sage_trac . Patch comments also say stuff like > "trac #1234", not "ticket #1234".

[sage-devel] Re: Sphinx TODO extension

2011-04-25 Thread Keshav Kini
I also prefer trac, but I know why: it's shorter! Also it's more clearly related to trac.sagemath.org/sage_trac . Patch comments also say stuff like "trac #1234", not "ticket #1234". And yeah, I'm with John - it's a waste to use sphinx and not take advantage of its capabilities. The same goes f

[sage-devel] Re: Sphinx TODO extension

2011-04-25 Thread slabbe
> I'm thinking about something like :ticket:`3412` or :trac:`2132`. > Any preferences or objections ? I prefer trac. I don't know why. Sébastien -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@google

Re: [sage-devel] Re: Sphinx TODO extension

2011-04-25 Thread Florent Hivert
> > It seems like a good idea to me. Should we also add a comment to the > > developer's guide about this kind of mark-up for the documentation? > > Good idea. Done. In the same veins, I think that links to trac ticket should be hyperlinks. Sphinx extlinks extension make it very easy. The only

Re: [sage-devel] Re: Sphinx TODO extension

2011-04-25 Thread Florent Hivert
Hi John, > > I'm working on #9128 whose goal is to resolve dangling links by looking in > > python docs and in sage.all. On the way, I noticed that there are lots of > > todos in the doc but no systematic way to handle them in sage. Fortunately, > > there is a nice sphinx extension to handle

[sage-devel] Re: Sphinx TODO extension

2011-04-25 Thread John H Palmieri
On Monday, April 25, 2011 10:04:04 AM UTC-7, fhivert wrote: > > Hi there, > > I'm working on #9128 whose goal is to resolve dangling links by looking in > python docs and in sage.all. On the way, I noticed that there are lots of > todos in the doc but no systematic way to handle them in sage