> > My suggestion would be > > OUTPUT: > > - If ``certificate=True`` return only True or False. > - If ``certificate=False`` return either > * (True, XX), where XX is... > * (False, XX), where XX is... > > > I think this is too much information which will overlap with the INPUT block or even a small paragraph that goes before the INPUT block, that explains the certificate stuff. The only thing I want to see in the OUTPUT block is the *type* of the objects and how many of them.
So in the ultra rare case of output type or length depending on some flag, I would go for: OUTPUT: boolean or a 2-tuple (boolean, XX) if certificate is True In all other case and in particular for what is suggested for the guideline which will apply to almost all cases, I would go +1 for H5 (or +1 for Jeroen's shorter suggestion. I don't really mind actually). Sébastien -- 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.
