Hello, Sage developpers !

I created a ticket to correct some annoying problem about
documentation in graph theory
http://trac.sagemath.org/sage_trac/ticket/8513

I can fix it myself, but I would like to have some opinions before
doing so. The question is, should we just add the reference to these
files without caring about Sphinx warnings (and correct them
progressively) or is it better to fix all of them to the risk of
having to rebase many patches still pending for reviews in graph
theory ?

Thank you !

Alex

P.S. Here is the description of the ticket

I noticed a few weeks ago while reviewing a patch that important files
in the graph theory folder were not appearing anywhere in the
reference manual. For instance, functions such as vertex_cut or
edge_cut do not appear, as well as all functions defined only for
directed graphs.

At that time, I thought about adding the missing files with the patch,
but since there were a lot of warnings displayed by Sphinx while
generating the documentation, I changed my mind.

I think it would be a good idea to use this ticket to fix this, but
since it touches many files of graph theory, it may be hard to do it
in a clean way. Someone has an idea of what would be the best
approach ?

-- 
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...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URL: http://www.sagemath.org

Reply via email to