8 ms·
Trying to do literate programming in traditional languages is pretty crappy [1]. Some heroic effort ended up having to go into this release as well so things ar
by ibdknox 10y ago
Trying to do literate programming in traditional languages is pretty crappy [1]. Some heroic effort ended up having to go into this release as well so things aren't as commented as we wanted, but that will improve. There are a few files that are pretty good though [2].
Our Eve source on the other hand is wonderfully literate and it's been a really great experience. Here's the code that makes the inspector work [3].
[1]:http://programming.witheve.com/deepdives/literate.html http://programming.witheve.com/deepdives/literate.html
[2]: https://github.com/witheve/Eve/blob/master/src/runtime/join.ts#L683 https://github.com/witheve/Eve/blob/master/src/runtime/join....
[3]: http://play.witheve.com/#/examples/editor.eve http://play.witheve.com/#/examples/editor.eve
- brianwawok 10y agoI only looked at 2.. but honestly, that looked like the kind of code I got delivered from offshore teams. 3 lines of comments saying what a for loop will do, then 1 line to do the for loop. I would -1 most of that on a code review, and ask for comments that just describe what the code is doing to be removed.
- zubairq 10y agoI can show you plenty of crappy code delivered from local teams too, especially myself!