Many years ago (over ten, I think), when I was ver...
# linking-together
i
Many years ago (over ten, I think), when I was very inspired by wikis, I put a couple of pages on the original wiki about the possibility of using wikis to develop software, or to give our IDEs wikilike (social, easy hyperlinking) etc. capabilities. It's been a long time since I looked at these pages, but they have grown a bit with contributions from other people in the community since then, and there are still some interesting thoughts there : http://wiki.c2.com/?ProgrammingInWiki , http://wiki.c2.com/?WikiIde
👍 6
❤️ 2
k
I used a trick for a few years that would teach
ctags
about wikiwords so I could refer to large comments on specific design decisions by name in arbitrary places.
In a different direction, I spent a while ten years ago noodling on a 'wikipedia for open source projects'. Changing code is too complex to do on the browser (I thought then) so treat the code as immutable, or rather as an immutable stream of changes flowing in the background. But as people try to make sense of how some code works, make it easy for them to add annotations on a web UI at the moment of insight (ah, so that's why this is written like so!). To address the problem of annotations getting outdated, tie them to a single snapshot, and provide filters and visual indicators for displaying annotations from old versions. (And of course allow others to edit annotations.)
👍 1
💡 1
i
Interesting thought. In a sense things like Github do a job of providing some web annotations to a code base, but it could be done at a finer-grained level with actual annotations to the code itself, not IN the code, but in the github page about it. Or not necessarily github you could put it into any web front-end to git.
k
Yeah, exactly.
d
like some additional views on top of https://codestream.com/ ?
😁 1