My Reference Code Shelf



December 17th, 2017 by Diana Coman

Reading code is a pain or a gain, depending on whose1 code you read, of course. And while I had a rather significant share of pain since my recent return to programming a few years ago, I recently enjoyed as well some gains. Reading code is quite like reading literature in this respect really, except that for code2 there are precious few - if any - editors to intently review some proposed piece of code and personally, publicly vouch for it. Or on the contrary but just as useful, publicly vouch *against* it.

Arguably, vouching against some code might be more salutary - and even more sanitary - in the light of the horrors that can be routinely found in the current brave world of everyone can code. Still, I'm an optimist here3 and I'd much rather focus therefore on the positive: the reading and reviewing of good code, the vouching for the rare but therefore even more precious pieces of code that are a delight to read and, more importantly, a rock-solid piece of foundation on which one can build further. Note that perfection is neither implied nor the objective here as code is not some ideal construct made by Gods or out of pure thought: code that I sign is code I consider honest, useful and readable, approximately in this order. My definition for those may even differ from yours, so make and assume your own decisions on this matter. Just like I am making and publicly assuming mine.

For such important pieces of code that I got to read, to know and to accept as honest, useful and readable, I will provide therefore my signature for whatever it may be worth to another reader and a place on my public shelf from where one can download the code itself, my signature for it and any other signatures for it from people that I trust essentially with this important but not always easy task of reviewing code.

This is in my opinion the least I can do to support the very sane and very dear to me approach of rewarding intelligence so I see it essentially as my duty too.


  1. Yes, code IS quite personal in this sense - it's not an anonymous or machine-made artefact but someone's own output and as such part of their quite personal public image. 

  2. My suspicion is that the situation is rather similar for literature nowadays, but literature has seen happier days, what can I say more. 

  3. The sort of optimist who finds out from experience that idiocy has infinite points

Comments feed: RSS 2.0

3 Responses to “My Reference Code Shelf”

  1. […] remind two events: Stanislav began writing his epic FFA series, and Diana introduced her very own reference code shelf, to which she has already added a few pieces. I find the latter to be particularly interesting: […]

  2. [...] December 2017, I started my Reference Code Shelf and noted in its very introduction that code is the current literature and V-signatures enable meaningful reviewing and as a result publishing of the text known as [...]

Leave a Reply