#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:
Authors: Nicolas M. Thiéry | Work issues:
Report Upstream: N/A | Commit:
Branch: | cef0ee08f43e178766f6a737b2d4ea18ac8fd90c
u/nthiery/ticket/16256 | Stopgaps:
Dependencies: #16058, #17189 |
-------------------------------------+-------------------------------------
Comment (by aschilling):
Replying to [comment:81 jpflori]:
> Replying to [comment:80 aschilling]:
> > Replying to [comment:75 jpflori]:
> > > Replying to [comment:72 aschilling]:
> > > > Some quick comments that I think should really be fixed:
> > > > - The alphabetical module list is not alphabetical
> > > That's how `ls` sorts stuff, I don't think that's a terrible choice.
> > > Is it the way capitals and underscores are dealt with that you don't
like?
> > > This can be easily changed.
> >
> > I found it confusing that it says on the top that the list is in
alphabetical order, but then it is not. Since a user won't know what kind
of sort is used, it is hard to guess (unless it is explained how the sort
is done).
> >
> Yes, I actually first checked the source file whence my
misunderstanding.
> I propose to add more info on why this does not look alphabetical first
and use sphinx to get a better ordering in a follow up ticket if you think
it is ok.
Or we could just remove the header claiming that this is an alphabetical
ordering!
I just think that that part is confusing for a user.
--
Ticket URL: <http://trac.sagemath.org/ticket/16256#comment:82>
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.
