[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