#14473: Old deprecation warnings, and depth of doc index
---------------------------------+------------------------------------------
Reporter: ncohen | Owner: sage-combinat
Type: defect | Status: needs_review
Priority: major | Milestone: sage-5.10
Component: combinatorics | Resolution:
Keywords: | Work issues:
Report Upstream: N/A | Reviewers: Travis Scrimshaw
Authors: Nathann Cohen | Merged in:
Dependencies: | Stopgaps:
---------------------------------+------------------------------------------
Comment (by ncohen):
Yo !
> I do not like the result of decreasing the combinatorics doc's depth.
Oh. Ok.
It really is a mess right now, you know..
http://www.sagemath.org/doc/reference/combinat/index.html
> The principle is to improve the readability of the combinatorics
documentation, and that is what the review patch aims to do.
Which review patch are you talking about ?
> Plus it was something I was already working on.
Well. Yeah, but it's not done yet...
> If you want to remove the old deprecations, we can do that now
Cool, let's do it then !
> , but I do not want the doc's depth to simply decrease. I believe this
makes it more difficult to look through the reference manual (for things
not sitting at the combinatorics level, ex. symmetric functions,
crystals).
Well, symmetric functions and crystal would both have an entry in the
reduced listing. And as there would be fewer entries one would have an
actually chance to see them.
The other point is that reducing the depth would have made people take
care of the doc instead of putting anything there randomly to be used with
"Ctrl + f".
But if you work on this right now and if you say that the patch will be
ready soon, after all.. It has been like that for so long !
I just updated the patch, which now does not change the depth of the
combinat doc page. It still changes the depth of the posets page, but you
can check there http://www.sagemath.org/doc/reference/combinat/posets.html
that only "Classes and functions" would be removed.
Nathann
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/14473#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?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.
