#8513: Including documentation in the reference manual for some files related to
graph theory
----------------------------+-----------------------------------------------
   Reporter:  abmasse       |       Owner:  rlm                        
       Type:  defect        |      Status:  needs_review               
   Priority:  minor         |   Milestone:  sage-4.4                   
  Component:  graph theory  |    Keywords:  documentation, graph theory
     Author:                |    Upstream:  N/A                        
   Reviewer:                |      Merged:                             
Work_issues:                |  
----------------------------+-----------------------------------------------

Comment(by abmasse):

 Replying to [comment:9 jhpalmieri]:
 > I don't know much about graph theory, but is there any sense to the
 current order in the reference manual?  Wouldn't it make more sense for
 {{{graph}}} to come first, for example, rather than {{{cliquer}}}?  I
 don't think alphabetical is the right approach: someone who wants to know
 about graphs in Sage may very well start at the first link in the "Graph
 Theory" chapter.  (It might be even better to have an introductory section
 in the file devel/sage/doc/en/reference/graphs.rst (like matrices.rst, for
 example).  That probably belongs on another ticket, though.)

 I agree with you! There is some cleanup needed in the documentation. But
 maybe we should wait for it in another ticket. The goal of #8513 is to
 quickly make the graph documentation available so that one may check if
 Sphinx builds all right when reviewing related tickets. If it's ok for
 you, of course.

 Sorry for being so late, by the way, Nathann, I'll try to finish this
 ticket today or at most, during the week.

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/8513#comment:10>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica, 
and MATLAB

-- 
You received this message because you are subscribed to the Google Groups 
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/sage-trac?hl=en.

Reply via email to