➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author bmispelon
Recipients bmispelon, docs@python, mdk, serhiy.storchaka, terry.reedy
Date 2019-12-09.21:41:44
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1575927704.7.0.59738595148.issue38975@roundup.psfhosted.org>
In-reply-to
Content 
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?
History
Date User Action Args
2019-12-09 21:41:44bmispelonsetrecipients: + bmispelon, terry.reedy, docs@python, serhiy.storchaka, mdk
2019-12-09 21:41:44bmispelonsetmessageid: <1575927704.7.0.59738595148.issue38975@roundup.psfhosted.org>
2019-12-09 21:41:44bmispelonlinkissue38975 messages
2019-12-09 21:41:44bmispeloncreate