Ayende @ Rahien

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

ayende@ayende.com

+972 52-548-6969

, @ Q c

Posts: 5,953 | Comments: 44,408

filter by tags archive

Comments

Joe
Joe

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.

Richard

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 :)

Jake

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

firefly

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.

FUTURE POSTS

No future posts left, oh my!

RECENT SERIES

  1. The RavenDB Comic Strip (3):
    28 May 2015 - Part III – High availability & sleeping soundly
  2. Special Offer (2):
    27 May 2015 - 29% discount for all our products
  3. RavenDB Sharding (3):
    22 May 2015 - Adding a new shard to an existing cluster, splitting the shard
  4. Challenge (45):
    28 Apr 2015 - What is the meaning of this change?
  5. Interview question (2):
    30 Mar 2015 - fix the index
View all series

Syndication

Main feed Feed Stats
Comments feed   Comments Feed Stats