Consistency in code examples, newline or no newline?

[StanFromIreland]

Currently there is a mixture of including the empty line and not including it for example in the decimal docs:

>>> def mul(x, y, fp=TWOPLACES):
    ...     return (x * y).quantize(fp)
    ...

>>> def div(x, y, fp=TWOPLACES):
    ...     return (x / y).quantize(fp)

>>> def remove_exponent(d):
    ...     return d.quantize(Decimal(1)) if d == d.to_integral() else d.normalize()

I propose we standardize this to either including it or not including it. (I'm a very big fan of consistency)

[AA-Turner]

I'm not sure I understand? The page you reference seems consistent, in that the examples reflect a console session.

Do you mean the lack of a trailing ... line in the div and remove_exponent cases?

A

[StanFromIreland]

@AA-Turner

Yes, I propose to either always have it or never have it.

[AA-Turner]

I don't think we should add a final ... line solely for consistency's sake. Adding unnecessary continuation lines creates visual noise and make-work, and removing them makes examples less readable.

Others may disagree with me, but absent anything else I propose rejecting this proposal.

A