In reply to @asymmetric:matrix.dapp.org.uk
just to be clear: i'm arguing for soft line breaks (a newline inserted by the editor) at some arbitrary column, say 80

In reply to @Minijackson:matrix.org
I've done that for quite some time, but I found that diffs becomes unreadable, which is an issue for PRs that needs to be reviewed

In reply to @Minijackson:matrix.org
I've done that for quite some time, but I found that diffs becomes unreadable, which is an issue for PRs that needs to be reviewed

-The beauteous scheme is that now, if you change
-your mind about what a paragraph should look
-like, you can change the formatted output merely
-by changing the definition of ‘‘.PP’’ and
-re-running the formatter.
+The beauty of this scheme is that now, if you
+change your mind about what a paragraph should
+look like, you can change the formatted output
+merely by changing the definition of ‘‘.PP’’
+and re-running the formatter.

I liken it to: imagine a program written in something like Nix or C. Now, imagine instead of one statement per line, the entire program was smushed together, with newlines only occurring at the 80 col mark.

...now, imagine receiving a substantial PR to change something in that spaghetti :D

In reply to @osslate:fsfe.org

I liken it to: imagine a program written in something like Nix or C. Now, imagine instead of one statement per line, the entire program was smushed together, with newlines only occurring at the 80 col mark.

...now, imagine receiving a substantial PR to change something in that spaghetti :D

In reply to @asymmetric:matrix.dapp.org.uk
But the 80 column mark provides an upper bound for sentence length

I'm trying to make an extension that replaces the nix-repl language tag with the text language tag. By language tag I mean the first word after the triple backtick in fenced code blocks.

from docutils import nodes
from docutils.parsers.rst import directives
from sphinx.util.docutils import SphinxDirective

class Directive(SphinxDirective):
    has_content = True

    def run(self):
        content = '\n'.join(self.content)
        code_block = nodes.literal_block(classes=['nix-repl'], language='text')
        code_block.append(nodes.Text(content))
        return [code_block]

def setup(app):
    app.add_directive('nix-repl', Directive)