#13260: Add tutorials and quickstarts from PREP workshops to standard
documentation
---------------------------------------+------------------------------------
Reporter: kcrisman | Owner: mvngu
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-5.3
Component: documentation | Resolution:
Keywords: | Work issues:
Report Upstream: N/A | Reviewers: André Apitzsch, Andrey
Novoseltsev, John Palmieri, Benjamin Jones
Authors: Karl-Dieter Crisman | Merged in:
Dependencies: | Stopgaps:
---------------------------------------+------------------------------------
Comment (by kcrisman):
> > Programming.rst:
> > * Line 546: the warning here appears in the HTML docs, but the two
blocks below don't, so that's confusing. I don't recall what the skip
directive actually does, but in this case it seems to leave the blocks
omitted.
> The skip directive is only supposed to skip it for testing. I seem to
remember that they did indeed show up in the right place, but otherwise
the fix is to just move the examples to the "usual" spot.
This was trickier. Moving the "skips" fixed the typesetting problem, but
then the cells weren't skipped in doctesting. I fixed this by just adding
the `# not tested` business.
> > Advanced-2DPlotting.rst:
> > * Line 409: typsetting mistake
> I assume there is no irony intended with the typo in this bullet. I
don't see what the problem is right now, but I'll try to fix it.
Ok, I see what you mean. I had single backticks instead of doubles.
----
As long as no one minds, although I removed the quickstart stuff from this
ticket, I left the (two) images, because I wasn't sure how to hg rm a file
from within the middle of a queue. I seriously doubt this will cause any
problems.
----
For my own reference:
{{{
In the :doc:`Quickstart tutorials <quickstart>`, we assume
familiarity with the topics at the level of a student who has just
completed a course in the subject, or of a faculty member who is about
to teach it.
- Quickstart Tutorials <quickstart>
}}}
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/13260#comment:29>
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 post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
