12 ms·
It wasn’t so much the code that I found less discoverable with the literate style, more the relevant documentation when reading any given part of the code. I fo
by Chris_Newton 2y ago
It wasn’t so much the code that I found less discoverable with the literate style, more the relevant documentation when reading any given part of the code. I found the linear flow didn’t really lend itself to quickly finding all relevant commentary about any given piece of code, since it tends to encourage building up a “big picture” and so there could easily be comments much earlier in any given chapter/file that were relevant to later code but with no obvious way to know that and find them short of reading the whole thing from front to back.
- WillAdams 2y agoI use section markers/Xrefs to help with that.