#9321: Documentation for sum() function should indicate Python syntax *first*
-------------------------+-------------------------------------------------
       Reporter:  rlm    |        Owner:  mvngu
           Type:         |       Status:  needs_review
  defect                 |    Milestone:
       Priority:         |   Resolution:
  critical               |    Merged in:
      Component:         |    Reviewers:  Karl-Dieter Crisman, Travis
  documentation          |  Scrimshaw
       Keywords:         |  Work issues:
        Authors:  Ralf   |       Commit:
  Stephan                |  eb0ddc0a0269fe7e26ced69b162000b1b9aa1a6b
Report Upstream:  N/A    |     Stopgaps:
         Branch:         |
  u/rws/ticket/9321      |
   Dependencies:         |
-------------------------+-------------------------------------------------

Comment (by kcrisman):

 Okay, I'm going to ask for one final thing.  Probably it isn't appropriate
 to have this warning be before one even sees the INPUT block!  Can you put
 this after the first few examples, and then have some wording indicating
 "now back to the examples" in a not-informal way?  Otherwise we'll have
 the opposite problem of everyone avoiding this function :)

 Also, another nit-pick - try to put the `sum()` in double back ticks so
 that it typesets properly as code.  And... is there any general reference
 for the Python sum, or are all of them version-dependent?  (I think the
 latter, just checking in case you know).

 Thanks! Sorry this is an incremental review but it will be more awesomer
 soon.

--
Ticket URL: <http://trac.sagemath.org/ticket/9321#comment:14>
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.

Reply via email to