#16256: Reorganize the documentation indexes into src/sage/combinat
-------------------------------------------------+-------------------------
Reporter: nthiery | Owner:
Type: enhancement | Status: new
Priority: major | Milestone: sage-6.2
Component: documentation | Resolution:
Keywords: combinatorics, thematic | Merged in:
index, quickref | Reviewers:
Authors: Nicolas M. Thiéry | Work issues:
Report Upstream: N/A | Commit:
Branch: | Stopgaps:
Dependencies: #16058 |
-------------------------------------------------+-------------------------
Comment (by nthiery):
Replying to [comment:7 ncohen]:
> Can you be sure it's the only one?
I don't have a formal proof, no :-) We will have to double check this
systematically. Like for any other reorganization.
> Okay, whatever. If the addition above is not about a script that has to
be run before generating the doc, it has nothing to do there.
This is documentation on how to update the module_list file; the top
of this file is a natural spot for it. In any cases this is meant to
be replaced by "automatically generated file; don't touch", so there
is no point discussing it.
> What is the point of having an index like that instead of the human-made
index page, i.e. the one that is being worked on on this ticket ?
For the reader that's indeed essentially pointless: sphinx already
provides an index of all documented modules. However sphinx currently
needs to have somewhere a list of all the modules for which it's
supposed to build the documentation, in the form of a toctree. Other
than that, I'd be more than happy to simply get rid of it.
--
Ticket URL: <http://trac.sagemath.org/ticket/16256#comment:9>
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.
