I think that having an optional Sphinx block is a good idea. Perhaps it could be colored differently in the html documentation (like WARNING blocks are)? When printing on the command line, I think we're just used to the #optional tag. It's unclear to me whether the #optional tag or an OPTIONAL block is more confusing/more likely to be missed for a new user.
I agree with Volker and Jeroen that a module level optional tag is not a good idea, since it's not localized. David On Wed, Apr 13, 2016 at 5:58 PM, Simon King <[email protected]> wrote: > > Am Mittwoch, 13. April 2016 19:22:12 UTC+2 schrieb Volker Braun: >> >> Or just call the block OPTIONAL, so that >> >> EXAMPLES:: >> >> sage: bar() # optional - foo >> sage: baz() # optional - foo >> >> is equivalent to >> >> OPTIONAL - foo:: >> >> sage: bar() >> sage: baz() >> > > I like that proposal. > > -- > 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. > -- 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.
