I think the fact that spending a few weeks commenting code can be a great use of developer time is something a lot of shops overlook. I was briefly optimistic that might be changing when we had a bunch of popular libraries (basically all JavaScript, weirdly) that were practically examples of literate programming (Underscore, Backbone, and CoffeeScript, for example), but that seems to have petered out.
I’m impressed by the improved commenting; the source is actually readable now rather than being wall-of-C.
I think the fact that spending a few weeks commenting code can be a great use of developer time is something a lot of shops overlook. I was briefly optimistic that might be changing when we had a bunch of popular libraries (basically all JavaScript, weirdly) that were practically examples of literate programming (Underscore, Backbone, and CoffeeScript, for example), but that seems to have petered out.
I don’t think it’s a coincidence that each of these had the same principal author: Jeremy Ashkenas.