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,026 | Comments: 44,842

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. Technical observations from my wife (3):
    13 Nov 2015 - Production issues
  2. Production postmortem (13):
    13 Nov 2015 - The case of the “it is slow on that machine (only)”
  3. Speaking (5):
    09 Nov 2015 - Community talk in Kiev, Ukraine–What does it take to be a good developer
  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