| commit | 8f570aa78b6a5afd153126a447f2b76773720d09 | |
| author | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | |
| Fri, 3 May 2024 20:25:50 +0000 (3 20:25 +0000) | ||
| committer | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | |
| Fri, 3 May 2024 20:25:50 +0000 (3 20:25 +0000) | ||
| tree | 1e8f2126b316365920aceda732e6f18214df3126 | treesnapshot (tar.gz zip) |
| parent | 45bc24e0599c80321a5f3813d0aad91cbfe2d1ed | commitdiff |
Doctree documentation: make documentation more concise.
Don't put element "Details" into a separate subsection
but just after a short element definition.
Do not repeat descriptions from the "details" list
in plain text description.
+ Less overhead and less scrolling in both, source and HTML.
+ A longer free-text description can move below the "details"
field-list making it more prominent and the overall structure of
element sections more uniform.
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@9673 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Don't put element "Details" into a separate subsection
but just after a short element definition.
Do not repeat descriptions from the "details" list
in plain text description.
+ Less overhead and less scrolling in both, source and HTML.
+ A longer free-text description can move below the "details"
field-list making it more prominent and the overall structure of
element sections more uniform.
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@9673 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
| docutils/docs/ref/doctree.txt | diffblobblamehistory |