Bug #22077
Updated by Brett Smith 4 months ago
We wrote our Python documentation style guide with the expectation that the Markdown renderer would convert @---@ to @—@. And in early versions it did. After #19929, something changed in our documentation so that this rendering no longer happens consistently. It still happens sometimes, but not all the time. Sometimes it's not even consistent in the same docstring. Compare in this scerenshot: all the arguments use triple-minus-hyphen in the source, and it renders as an em dash for the body argument, but not any others: Compare: !clipboard-202409091046-16rdu.png! Fix this. A fix might need to happen in upstream pdoc or its Markdown rendering library.