[-- Attachment #1: Type: text/plain, Size: 828 bytes --] Hi, I was reading the org manual section on source code blocks and I think there’s a small section where the clarity can be improved. Section 15.1: Features Overview, first paragraph (line 16396 of org.org) original: …Users can control how live they want each source code block… proposed change 1: …control how [“live”] they want… proposed change 2: …control [the “liveliness” of] each source… When the paragraph first introduces the term “live code block”, it’s italicized. I think it should stay italicized for the rest of that paragraph since it’s the introduction of the term (I had to re-read the sentence a few times myself before it fully made sense). Just a small suggestion; it wasn’t detrimental to my understanding or anything but more of a small hiccup. Best, Ian [-- Attachment #2: Type: text/html, Size: 2137 bytes --]
Ian wrote:
> When the paragraph first introduces the term “live code
> block”, it’s italicized. I think it should stay italicized
> for the rest of that paragraph since it’s the introduction
> of the term
I am not one of the authors of the manual, but my impression, after spending most of my life reading manuals, scientific reports, and a lot of other terminology-rich literature, is that new terms are typographically emphasised once and once only.
Cheers
Rasmus