#13381: Add 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:
Authors: Karl-Dieter Crisman | Merged in:
Dependencies: #13260 | Stopgaps:
---------------------------------------+------------------------------------
Old description:
> This ticket is to add the quickstart tutorials, originally at #13260. It
> was split off from that ticket for convenience.
>
> Apply [attachment:trac_13381-quickstarts.patch].
New description:
This ticket is to add the quickstart tutorials, originally at #13260. It
was split off from that ticket for convenience.
Apply [attachment:trac_13381-quickstarts.patch] and
[attachment:trac_13381-ref.patch].
--
Comment (by jhpalmieri):
Here is a referee patch. If it's okay with you, then one item remains to
be addressed: in `NumAnalysis.rst`:
- "The first step is to normalize" - The first step in what? It's not
clear what's being done here. It looks like you want to convert x to
floating point binary, but it also looks like that was done a few lines
earlier in `x.str(base=2)`. So a little more explanation would be helpful.
Other comments (I think most of my changes are self-explanatory):
- in `Abstract-Algebra.rst` and elsewhere, I've changed `\ZZ_n` to
`\ZZ/n\ZZ`. The subscript notation is ambiguous — many people will read
`\ZZ_p` as denoting the p-adics, not the integers mod p, and so in my
opinion this notation should never be used to denote quotient rings of the
integers.
- in `Linear-Algebra.rst`, I've added a definition of "left kernel":
personally, I can tell from the name "left kernel" that either the matrix
or the vector is supposed to be on the left, but I can never remember
which.
The use of upper case in the file names here (and in the parent directory)
doesn't follow the same pattern as elsewhere in the Sage library. This is
certainly not a big deal, but it looks a little strange to me.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/13381#comment:3>
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.
