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