Re:Lisp.py
by abrax3141 on Wednesday July 20, 2022 @10:24AM
(#32166202)
I dislike this style. First off, it’s just a block comment. Secondly, although raw markdown isn’t terrible to read, it makes it slightly hard to read the actual code as text, say in emacs. But the worst thing is that folks who code like this tend away from inline comments, which I find usually more useful in complex code.
[ Parent
| on HN ]
IIRC Docco uses line comments, I'm not sure what your complaint is about. Besides, Emacs has two-column editing mode, making it possible to have side-by-side comments without any external tools. Also, third-party packages like separedit allow comment editing in an indirect buffer. My point is - with little regard for how it's written originally, Emacs (more than any other tool) grants ways of making it suitable for you, personally. You can make things more readable, or optimize them for writing.