#18093: Improve deprecation doc
-------------------------------------+-------------------------------------
Reporter: jdemeyer | Owner:
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-6.6
Component: documentation | Resolution:
Keywords: sd66 | Merged in:
Authors: Jeroen Demeyer | Reviewers:
Report Upstream: N/A | Work issues:
Branch: | Commit:
u/jdemeyer/improve_deprecation_doc | 48a1fd677d9bfe5af1f311f3aa023e19ea13ebe9
Dependencies: | Stopgaps:
-------------------------------------+-------------------------------------
Comment (by ncohen):
Hellooooooo Jeroen,
I know, I sit just behind you but this software is open, so let's keep the
communication on this channel `:-P`
As I always try to make sentences "short and efficient", I removed some of
the text, believing that what is already there is sufficient for our
purposes. Is that okay with you?
Also, about the first sentence: when I began rephrasing some parts of the
doc, Karl-Dieter opposed some of my changes by saying that the manual did
not only need to be "short and efficient", but also welcoming to potential
developpers. Soooooooo well. For this purpose, I believe that the way the
first sentence was phrased (as a definition of 'deprecation') would be
more helpful to them, just in case they would wonder whether a deprecation
is some technical thing they should have heard about.
If you have something against the current phrasing, could we change the
new text so that this becomes a 'definition' again?
My commit is at public/18093
Thanks,
Nathann
--
Ticket URL: <http://trac.sagemath.org/ticket/18093#comment:4>
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.
