IDEA: some tool to make code easy to read. Linearize it, make it into a...
IDEA: some tool to make code easy to read. Linearize it, make it into a "literate programming experience"
This is for the "you wouldn't ship code you haven't read", except you'd be able to use it for `pip install code-i-definitely-did-not-read` and maybe the LLM generates a PPT slide show, a 20 minute talk in the style of a conference talk, and a quiz to test if you actually understood the code.
Self-replies
Existing source code to documentation artifact favors docs that you look up one or two things and get out. For example, the vast majority of `pymarc` is not code, but an ancient attempt at some alphabet encoding, and no one wants to spend 80% of their time reading that.