On Monday, April 11, 2016 at 11:43:46 PM UTC+1, Volker Braun wrote: > > IMHO thats terrible; When you copy&paste an example it should either work > or say very clear why it is optional. > I disagree. I remember that when my students saw sage documentation for the first time they did not understand what the `#` were about. (Because they were not aware that they are just comments.) Also, the repetition of these markers is just confusing. Often the just the first line is really about the optional feature. The following lines would work but the object under consideration could not be created. I think that having an "optional" marker at a function level is a very good idea. Of course, copying and pasting such lines should produce a clear error messages. We are working on that…
julian -- 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 [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.
