Ayende @ Rahien

My name is Oren Eini
Founder of Hibernating Rhinos LTD and RavenDB.
You can reach me by phone or email:


+972 52-548-6969

, @ Q c

Posts: 6,007 | Comments: 44,760

filter by tags archive



I put in a fix on some code many year back and it wasn't pretty, I did add comments along the lines "this code is a mess but it has to go in urgently - sorry in advance".

A couple of years later a developer came to me saying he was maintaining that same bit of code. Reading the comments and understanding my frame of mind actually made it easier for him to understand what was going on.


About 15 years ago I was working on a PICK system. I found some code with the following comment -

"Just a bloody comma - ignore it."

Lance C

I don't know, I'm still pretty annoyed :)


What tool do you use for your diagrams? Those are some pretty looking boxes and arrows :)


That's good documentation!

Frank Quednau

It's a lovely tool , very customizable, and it has learned a lot throughout the past 9 months. The ability e.g. to mark classes with attributes for means of performing specific code analysis on those types didn't exist end of last year. Let's see how far it goes.

Comment preview

Comments have been closed on this topic.


No future posts left, oh my!


  1. Speaking (3):
    23 Sep 2015 - Build Stuff 2015 (Lithuania & Ukraine), Nov 18 - 24
  2. Production postmortem (11):
    22 Sep 2015 - The case of the Unicode Poo
  3. Technical observations from my wife (2):
    15 Sep 2015 - Disk speeds
  4. Find the bug (5):
    11 Sep 2015 - The concurrent memory buster
  5. Buffer allocation strategies (3):
    09 Sep 2015 - Bad usage patterns
View all series



Main feed Feed Stats
Comments feed   Comments Feed Stats