Baptiste Mispelon <bmispe...@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 <rep...@bugs.python.org>
<https://bugs.python.org/issue38975>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to