#16256: Reorganize the documentation indexes into src/sage/combinat
-------------------------------------+-------------------------------------
Reporter: nthiery | Owner:
Type: enhancement | Status: positive_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 | a5208fd118f578f5f36a57caaf43e6a81e48653b
Branch: | Stopgaps:
u/nthiery/ticket/16256 |
Dependencies: #16058, #17189 |
-------------------------------------+-------------------------------------
Comment (by ncohen):
> Note: People using posets a bit seriously need to know about the
> existence of the categories to have an idea of where the available
> methods come from. So the links are not just about "lost readers". I
> am fine with the layout you propose though.
As far as the documentation is concerned, we should have all functions
appear in the poset index, even those that are implemented somewhere else.
There is no systematic way to 'guess' in which file a Poset function
should be implemented, so we must keep it simple at least on the user
side.
When it comes to the developper's side, it would also be nice if having
categories did not mean having to move functions where they do not belong.
The 'categories/' folder should only contain category code, not Poset-
specific code. Not any kind of mathematical code, actually.
Or perhaps we should move the categories/poset file to combinat/posets ?
That would make more sense to me.
Nathann
--
Ticket URL: <http://trac.sagemath.org/ticket/16256#comment:116>
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.
