bpo-27200: fix several doctests by marco-buttu · Pull Request #604 · python/cpython
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@berkerpeksag I did perceive Marco as lecturing, but rather giving the context for why he had a doubt about your suggestion.
Marco: the difference here with what PEP8 is talking about is that we are now (starting from approximately last year's PyCon sprint) actually trying to execute doctests, where we've never been worried about that in the past (and the use of : and :: may have been somewhat random). So as far as skipping doctests or not, there is no true pre-existing style to follow. We ought instead to figure out what we want to do documentation wide, and do it. And I do like Berker's suggestion, since it makes it explicit. I myself can never remember which colon form does which.