2 ms·
It's bizarre that we're still marking up code with comments like it's 1960. We need some sort of standard to include comments in code like footnotes, margin not
by Cacti 9y ago
It's bizarre that we're still marking up code with comments like it's 1960. We need some sort of standard to include comments in code like footnotes, margin notes, and so on, that allow us to better explain what is going on without changing the actual readability of the code.
It would require us to move away from strict file-and-text-editing as the end all of programming, which makes many uncomfortable of course. And you get into lock-in issues.
- dragonwriter 9y ago> It's bizarre that we're still marking up code with comments like it's 1960. We need some sort of standard to include comments in code like footnotes, margin notes, and so on, that allow us to better explain what is going on without changing the actual readability of the code. Actual comments already do that if the editor hides them by default; you don't need different syntax or abandoning pure-text representation, just the right editor features to do what you want.