We need a way to interleave our own notes into the source code.
It's like Bible study, everyone studies the same Bible, but everyone wants to have their own highlights and notes.
Some might say to use comments, but my Monday morning chain-of-thought doesn't belong in a comment.
I want a way to do literate coding. I want to interleave writings, and drawings, and editable code snippets that point to actual code in the code base -- and I want to see when those code snippets are stale, or have been edited by other developers (or agents).
I want a way to build up some artifact of my understanding that I control, that exists primarily to aid my understanding, and isn't constantly shifting as a thousand LLMs pass through the actual codebase changing everything.
The code used to be the canvas of the programmer. Now programmers have no canvas. They need a canvas. They can't understand things without a canvas to hold their thoughts.
The irony is, this would be a pretty trivial one shot project for a modern LLM to create that interfaces with the source control repository of your choice. It's basically an advanced note-taking app, which LLMs have been trained to death on. I bet you could get it to write it as a VS Code extension as well (or emacs macro, or... etc.)
Buttons840 · · focus · HN ↗
It's like Bible study, everyone studies the same Bible, but everyone wants to have their own highlights and notes.
Some might say to use comments, but my Monday morning chain-of-thought doesn't belong in a comment.
I want a way to do literate coding. I want to interleave writings, and drawings, and editable code snippets that point to actual code in the code base -- and I want to see when those code snippets are stale, or have been edited by other developers (or agents).
I want a way to build up some artifact of my understanding that I control, that exists primarily to aid my understanding, and isn't constantly shifting as a thousand LLMs pass through the actual codebase changing everything.
The code used to be the canvas of the programmer. Now programmers have no canvas. They need a canvas. They can't understand things without a canvas to hold their thoughts.
Silagi · · focus · HN ↗