Ayende @ Rahien

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

ayende@ayende.com

+972 52-548-6969

@

Posts: 5,947 | Comments: 44,540

filter by tags archive

Just show me the code...


I am one of those who have really hard time talking generalities. Mainly because lacking a frame of reference usually cause me to try to spin in all directions at once, and Depends is a really bad way to formulate an argument. More often than not, a concrete example, hopefully backed with a code sample that can be dissected, is much more valuable, simply because it focuses the discussion on the subject at hand, instead of scattering it over all the possibility matrix.

The other problem with just talking is that words are cheap, and it is fairly easy to speak in such general terms that the conversation will be meaningless. I got burned really bad on the real world with overly general discussions, and now I mostly tend to drive people crazy by asking more and more questions with regard to the implementation details.

Strangely enough, I don't have the issue of going from a mess of details to an overall view of how things are combined.


Comments

Francois Tanguay

When asking for a design/programming concept to be explained, I normally ask to see:

1- A high-level class diagram

2- Black-box Unit tests...

Class diagram will give me a general overview of the structure of the components while the black-box unit tests will give me a detailed view of most common usages of the public interface.

One thing worth mentioning is I rarely ask for "white-box" UTs which explain how the concept relate to its dependencies. And that, mainly because I consider those tests "inferior" because they only document how one uses the public contract of their dependency.

Jason Meridth

This reminds me of one of Linus Torvalds quotes, "Talk is cheap, show me the code"

context: http://lkml.org/lkml/2000/8/25/132

Comment preview

Comments have been closed on this topic.

FUTURE POSTS

No future posts left, oh my!

RECENT SERIES

  1. RavenDB Sharding (2):
    21 May 2015 - Adding a new shard to an existing cluster, the easy way
  2. The RavenDB Comic Strip (2):
    20 May 2015 - Part II – a team in trouble!
  3. Challenge (45):
    28 Apr 2015 - What is the meaning of this change?
  4. Interview question (2):
    30 Mar 2015 - fix the index
  5. Excerpts from the RavenDB Performance team report (20):
    20 Feb 2015 - Optimizing Compare – The circle of life (a post-mortem)
View all series

RECENT COMMENTS

Syndication

Main feed Feed Stats
Comments feed   Comments Feed Stats