#19503: strip TESTS blocks in introspection
-------------------------------------+-------------------------------------
Reporter: jhpalmieri | Owner:
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-6.10
Component: documentation | Resolution:
Keywords: | Merged in:
Authors: John Palmieri | Reviewers:
Report Upstream: N/A | Work issues:
Branch: | Commit:
u/jhpalmieri/TESTS | c659e025d483d55b4bf644fa2f367884c7a2ca20
Dependencies: | Stopgaps:
-------------------------------------+-------------------------------------
Comment (by kcrisman):
> @kcrisman: I'm not convinced by your examples of `TESTS` blocks. I
really do think that the examples you showed contain tests which are not
meant for end users.
Then we may agree to disagree. I find that those examples have useful
syntax examples that are not covered by the original ones.
I just feel like this is covering up the real problem, which is
methods/functions which don't have very detailed documentation. Why do we
need to not show these? It's fixing a problem that isn't a problem.
Things people don't understand they skip anyway; if `TESTS` isn't helpful,
it's because they made it to `TESTS` because `EXAMPLES` didn't do its job.
--
Ticket URL: <http://trac.sagemath.org/ticket/19503#comment:31>
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.
