[Doc-SIG] Proposal: don't nest optional brackets
Paul Moore
p.f.moore at gmail.com
Fri Jun 20 14:51:36 CEST 2008
On 20/06/2008, A.M. Kuchling <amk at amk.ca> wrote:
> My proposal is that we drop the nesting and write this as:
>
> warnings.filterwarnings(action [, message, category, module, lineno, append])
[...]
> What does everyone think?
Sounds OK to me - this is documentation, not a formal spec, so
readability is more important than absolute precision.
I wonder - what do other projects do? Consistency with common practice
is likely to help readability, as well.
Paul.
More information about the Doc-SIG
mailing list