urllib.parse.quote docstring has invalid reStructuredText markup about cpython

[encukou]

I assume that all docstrings should have valid reStructuredText markup.

That is not the case. What are you basing this assumption on?

[stevepiercy]

@encukou https://peps.python.org/pep-0287/

[encukou]

Thanks. I see where the confusion is coming from.
PEP 287 is an informational PEP, that is:

Informational PEPs do not necessarily represent a Python community consensus or recommendation, so users and implementers are free to ignore Informational PEPs or follow their advice.

And that PEP itself says (although in places obvious that aren't obvious now -- the PEP predates both Sphinx and Markdown):

• reStructuredText is being proposed as a standard, not the only standard. Its use will be entirely optional.

• The current policy for docstrings in the Python standard library is that they should be no more than concise hints, simple and markup-free (although many do contain ad-hoc implicit markup).

I'll close this issue, but join the doc-sig mailing list and ask about the PEP there.