#18534: Posets: Adding function from categories to index of functions
-------------------------------------+-------------------------------------
Reporter: jmantysalo | Owner:
Type: enhancement | Status: needs_review
Priority: minor | Milestone: sage-6.8
Component: documentation | Resolution:
Keywords: | Merged in:
Authors: Jori Mäntysalo | Reviewers:
Report Upstream: N/A | Work issues:
Branch: | Commit:
u/jmantysalo/posets__adding_function_from_categories_to_index_of_functions|
b31c216bae73e63b9066778e2a3d569536ca91d2
Dependencies: | Stopgaps:
-------------------------------------+-------------------------------------
Comment (by ncohen):
> That would be my suggestion number zero. But I wrote about that on sage-
devel, and was clearly rejected.
Is "Clearly rejected" the difference between my "I don't like it, so I
will not review it" and somebody else's "I don't like it, so you must not
do it"?
I still don't know what there is to reject. There was a Poset class with
everything inside, then somebody created a Poset category and suddenly it
magically becomes "the best place" to store code, even though there is
nothing in there.
> The fact that #18926 is a great improvement (thanks!) does not mean that
it will make documentation good. Good index is arranged by topic. And
actually I have used a little different phrasing in the index compared to
function.
You can do it with #18926 too. Instead of telling it to print all the
functions of the class, you can create several small tables from lists of
functions. This way the list is always sorted lexicographically, and you
also don't have to copy/paste the first line of each docstring (which gets
updated automatically).
Furthermore, because we will have a Python list of the function that are
indexed, we can later "check" that all functions appear, which we cannot
do at the moment.
Nathann
--
Ticket URL: <http://trac.sagemath.org/ticket/18534#comment:15>
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.
