| 6 | | But I think maybe that's outdated: I use change directives both with and without the blank line in other projects, and the argument/content is rendered the same either way—as part of the changenote. I'll try to figure out if Sphinx removed that restriction at some point (and if so why there's still an [https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-versionadded:~:text=There%20must%20be%20no%20blank%20line%20between%20the%20directive%20head%20and%20the%20explanation%3B%20this%20is%20to%20make%20these%20blocks%20visually%20continuous%20in%20the%20markup. admonition about it] in their docs). |
| | 6 | But I think that's outdated: Sphinx commit [https://github.com/sphinx-doc/sphinx/commit/7630467f842b0539081263d9568add2053a0021f 7630467] in Jan 2013 (Sphinx 1.2?) fixed the body-content paragraphs getting dropped. (fwiw, I use change directives both with and without the blank line in other projects, and the argument/content is rendered the same either way—as part of the changenote.) |
| | 7 | |
| | 8 | One more reason not to use our own custom directives. |