#11490: Add a thematic tutorial on coercion and categories
---------------------------------------------------------+------------------
Reporter: SimonKing | Owner:
mvngu
Type: enhancement | Status:
needs_review
Priority: major | Milestone:
sage-5.7
Component: documentation | Resolution:
Keywords: categories coercion thematic tutorial | Work issues:
Report Upstream: N/A | Reviewers:
Authors: Simon King | Merged in:
Dependencies: #14084 | Stopgaps:
---------------------------------------------------------+------------------
Comment (by SimonKing):
Replying to [comment:11 tscrim]:
> - In the `__cmp__` block, it might be worth noting that if `__cmp__` is
not implemented, bad things can happen when calling `cmp` (ex. #14065)
Didn't know that!
> - The block starting at line 319, the last sentence is `It not even
gives a wrong answer, but results in an error::`. I believe there should
be a "does".
You mean "It does not even give a wrong answer, but results in an error"?
> - The `.. note::` on line 580 should have a blank line following it
Really? But the html output looks fine in that location.
> - For the 5 axioms starting on line 725, shouldn't everything align (the
blocks are one space less than the first line) for proper formatting?
Looks fine in html.
> - Note block on line 935 needs a newline
> - The `.. warning::` block on line 1536 needs a newline
Looks fine in html
That said, if it is sphinx convention to have a blank line, then I'll
insert one.
> One last thing, this is more from my personal taste, but I think the
note/warning blocks should be capitalized as `.. NOTE::` and `..
WARNING::` to be consistent with the dev guide.
On some ticket (don't remember which one), I recall that both look the
same in the output, but I don't recall whether we want it capitalised or
not. So, if you say the dev guide recommends capitalisation, then I'll
change it.
> I'm sorry this turned into a bit of a laundry list of things.
Thank you!
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/11490#comment:12>
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.
