On Monday, May 22, 2017 at 10:24:32 AM UTC+2, Jeroen Demeyer wrote: > > I very much object to this: > > > If the output consists > > of several items, add each starting with a hyphen. > > If the output consists of several items, the OUTPUT string should > clearly mention that fact (and it should mention whether the output is a > tuple or list or some other structure with several items). >
To be clear, I meant the case that the output is by Return a, b, c My opinion is that the phrase "a tuple `(a,b,c)` where ..." is just redundant. Anyway I guess that different people have different opinions about this as well. > So something like: > > OUTPUT: > > - a tuple `(a,b,c)` where > > - ``a`` is ... > > - ``b`` is ... > > - ``c`` is ... > This is ugly. By your previous opinion, wouldn't you prefer this? OUTPUT: a tuple of ``(a,b,c)`` where - ``a`` is ... - ``b`` is ... - ``c`` is ... I think that the guideline of this thread combined with your one-liner style for OUTPUT allows this. -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.com. To post to this group, send email to sage-devel@googlegroups.com. Visit this group at https://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.
