Comments on: Understanding Code http://ealing.wordpress.com/2008/02/24/understanding-code/ Ealing is a long way away, y'know Wed, 27 May 2009 14:34:45 +0000 http://wordpress.com/ hourly 1 By: rrees http://ealing.wordpress.com/2008/02/24/understanding-code/#comment-6477 rrees Wed, 05 Mar 2008 20:42:44 +0000 https://ealing.wordpress.com/?p=105#comment-6477 Before I get my software design license revoked I should say that SteeringWheel.turnLeft/Right is just what a steering wheel physically does. In a domain or context sense the methods should be: SteeringWheel.steerLeft SteeringWheel.steerRight Before I get my software design license revoked I should say that SteeringWheel.turnLeft/Right is just what a steering wheel physically does. In a domain or context sense the methods should be:

SteeringWheel.steerLeft
SteeringWheel.steerRight

]]> By: rrees http://ealing.wordpress.com/2008/02/24/understanding-code/#comment-6476 rrees Wed, 05 Mar 2008 14:26:07 +0000 https://ealing.wordpress.com/?p=105#comment-6476 Some of the Domain Driven Design ideas of ubiquitous language help in that the code should follow the language of the domain. So SteeringWheel.turnLeft and SteeringWheel.turnRight for example which matches the procedure rule you have here. However some chained functions (such as the Builder pattern) cannot follow the return type name convention. Engine.ignition().withKey(myKey).start() I think that's readable but withKey has to return Ignition. Some of the Domain Driven Design ideas of ubiquitous language help in that the code should follow the language of the domain.

So SteeringWheel.turnLeft and SteeringWheel.turnRight for example which matches the procedure rule you have here.

However some chained functions (such as the Builder pattern) cannot follow the return type name convention.

Engine.ignition().withKey(myKey).start()

I think that’s readable but withKey has to return Ignition.

]]> By: sweavo http://ealing.wordpress.com/2008/02/24/understanding-code/#comment-6473 sweavo Thu, 28 Feb 2008 15:59:31 +0000 https://ealing.wordpress.com/?p=105#comment-6473 by applying the Steve rule http://weblogs.asp.net/alex_papadimoulis/archive/2005/04/22/403889.aspx then it's fair that "he/she" should be alternated with "he/Steve" when referring to programmers. by applying the Steve rule http://weblogs.asp.net/alex_papadimoulis/archive/2005/04/22/403889.aspx then it’s fair that “he/she” should be alternated with “he/Steve” when referring to programmers.

]]>