[issue38975] Add direct anchors to regex syntax documentation
Baptiste Mispelon
report at bugs.python.org
Mon Dec 9 16:41:44 EST 2019
Baptiste Mispelon <bmispelon at gmail.com> added the comment:
I've tried using subsection (level 3) for each syntax element and I'm not sure it's a big improvement.
Pros:
* Visible ¶ anchors which make it easier to copy/paste a reference link
Cons:
* <h3> headings have a slightly different style (bigger font, no background color)
* All the added titles show up in the table of content (might not be a problem)
* Lots of re-indenting is needed which makes the diff quite noisy (even without reflowing the paragraphs)
I'm not sure what's the best way to share this alternative. A new PR? An extra commit on the existing PR?
----------
_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue38975>
_______________________________________
More information about the Python-bugs-list
mailing list