#16256: Reorganize the documentation indexes into src/sage/combinat
-------------------------------------+-------------------------------------
       Reporter:  nthiery            |        Owner:
           Type:  enhancement        |       Status:  needs_review
       Priority:  major              |    Milestone:  sage-6.4
      Component:  documentation      |   Resolution:
       Keywords:  combinatorics,     |    Merged in:
  thematic index, quickref           |    Reviewers:  Anne Schilling
        Authors:  Nicolas M.         |  Work issues:
  ThiƩry, Jean-Pierre Flori          |       Commit:
Report Upstream:  N/A                |  f5aa239b4946392411d97f4269ef5e646e215bfc
         Branch:                     |     Stopgaps:
  u/nthiery/ticket/16256             |
   Dependencies:  #16058, #17189     |
-------------------------------------+-------------------------------------

Comment (by ncohen):

 Yo !

 > Yes this module is important! The first item in the list points to
 > it. The second item then points to the main constructors in this
 > module.

 Arg, I missed that.

 > Yes because this is about the internal data structure of posets; it
 > seems thus unlikely (in fact undesirable) that the user plays with
 > it. Note that it appears in the comprehensive module list.

 Oh. So it is indeed included in the doc. That means that if the doc of
 some Poset functions links a `HasseDiagram` function the link will work,
 does it ?

 > I could add it back if you believe it's important.

 If the links work that's fine. Indeed we don't want anybody playing with
 `HasseDiagram` directly.

 > > Sorry I can't experiment with your branch, the University where I am
 > > has some stupid proxy rules and I cannot download a git branch.
 >
 > Yikes ...

 Yeah, plus I need to login 10 times each time I want to post a comment,
 hoping that I did not logout during the 3 seconds it takes top paste my
 text and click on 'submit'

 >
 
http://sage.math.washington.edu/home/nthiery/sage/src/doc/output/html/en/reference/combinat/sage/combinat/posets/__init__.html

 Hmmm... It is me or is that 10x more unclear than the current page:

 http://www.sagemath.org/doc/reference/combinat/posets.html

 Currently if a guy just wants to know what Posets can do he will click on
 "Posets", and no other link makes any sense. Now among the links you have
 "Finite Posets (module), Poset (constructor), Posets (category), Poset
 (catalog)".

 I will add a commit this evening, or as soon as I can get 'git' to work.

 Nathann

--
Ticket URL: <http://trac.sagemath.org/ticket/16256#comment:110>
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 unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.

Reply via email to