Comments on: Coding: Make it obvious http://www.markhneedham.com/blog/2009/03/18/coding-make-it-obvious/ Thoughts on Software Development Sat, 13 Mar 2010 16:40:57 +0000 http://wordpress.org/?v=2.8.4 hourly 1 By: Book Club: Promiscuous Pairing & Beginner’s Mind (Arlo Belkshee) at Mark Needham http://www.markhneedham.com/blog/2009/03/18/coding-make-it-obvious/comment-page-1/#comment-22237 Book Club: Promiscuous Pairing & Beginner’s Mind (Arlo Belkshee) at Mark Needham Sat, 05 Sep 2009 06:13:40 +0000 http://www.markhneedham.com/blog/?p=1041#comment-22237 [...] person probably doesn't yet know how to do clever things with a language so they just do the most obvious implementation. I think this is certainly what we want to happen when a team is working on code [...] [...] person probably doesn't yet know how to do clever things with a language so they just do the most obvious implementation. I think this is certainly what we want to happen when a team is working on code [...]

]]> By: Brownfield Application Development in .NET: Book Review at Mark Needham http://www.markhneedham.com/blog/2009/03/18/coding-make-it-obvious/comment-page-1/#comment-19690 Brownfield Application Development in .NET: Book Review at Mark Needham Sun, 05 Jul 2009 14:50:27 +0000 http://www.markhneedham.com/blog/?p=1041#comment-19690 [...] is something which is seriously undervalued - I think it's very important to write your code in such a way that the next person who works with it can actually understand what's going on. The authors have a fantastic quote from Perl Best Practices: Always code as if the guy who ends [...] [...] is something which is seriously undervalued – I think it's very important to write your code in such a way that the next person who works with it can actually understand what's going on. The authors have a fantastic quote from Perl Best Practices: Always code as if the guy who ends [...]

]]> By: 97 Things Every Software Architect Should Know: Book Review at Mark Needham http://www.markhneedham.com/blog/2009/03/18/coding-make-it-obvious/comment-page-1/#comment-17137 97 Things Every Software Architect Should Know: Book Review at Mark Needham Sun, 17 May 2009 15:07:21 +0000 http://www.markhneedham.com/blog/?p=1041#comment-17137 [...] team to work with especially if they have to make production fixes. The need for the code to be obvious, testable, correct and traceable are pointed out as being [...] [...] team to work with especially if they have to make production fixes. The need for the code to be obvious, testable, correct and traceable are pointed out as being [...]

]]> By: Ryan Kohn http://www.markhneedham.com/blog/2009/03/18/coding-make-it-obvious/comment-page-1/#comment-12897 Ryan Kohn Tue, 24 Mar 2009 17:10:58 +0000 http://www.markhneedham.com/blog/?p=1041#comment-12897 It boils down to the battle between having concern for other people and satisfying your own selfish goal to produce working code and immediately forget about it. I suspect that in an environment where communication between developers is encouraged, code readability increases dramatically. See Jurgen Appelo's post on the topic of communication: http://www.noop.nl/2009/03/communication-information-relationships.html. I also just posted on this topic: http://ryan.kohn.ca/articles/writing-empathetic-code.php It boils down to the battle between having concern for other people and satisfying your own selfish goal to produce working code and immediately forget about it.

I suspect that in an environment where communication between developers is encouraged, code readability increases dramatically.

See Jurgen Appelo's post on the topic of communication: http://www.noop.nl/2009/03/communication-information-relationships.html.

I also just posted on this topic:
http://ryan.kohn.ca/articles/writing-empathetic-code.php

]]> By: links for 2009-03-24 « pabloidz http://www.markhneedham.com/blog/2009/03/18/coding-make-it-obvious/comment-page-1/#comment-12881 links for 2009-03-24 « pabloidz Tue, 24 Mar 2009 12:03:45 +0000 http://www.markhneedham.com/blog/?p=1041#comment-12881 [...] Coding: Make it obvious Mark Needham (tags: programming) [...] [...] Coding: Make it obvious Mark Needham (tags: programming) [...]

]]> By: Sean Nieuwoudt http://www.markhneedham.com/blog/2009/03/18/coding-make-it-obvious/comment-page-1/#comment-12657 Sean Nieuwoudt Fri, 20 Mar 2009 08:00:54 +0000 http://www.markhneedham.com/blog/?p=1041#comment-12657 Thanks for the read. from experience I find that having some kind of coding specification is the best way to keep things simple in a team. This combined with a framework make for less painful pickups from another programmers code. Sean http://twitter.com/SeanNieuwoudt Thanks for the read.

from experience I find that having some kind of coding specification is the best way to keep things simple in a team. This combined with a framework make for less painful pickups from another programmers code.

Sean
http://twitter.com/SeanNieuwoudt

]]> By: Carlo http://www.markhneedham.com/blog/2009/03/18/coding-make-it-obvious/comment-page-1/#comment-12637 Carlo Thu, 19 Mar 2009 22:18:47 +0000 http://www.markhneedham.com/blog/?p=1041#comment-12637 You should take a look at Kent Becks book Implementation Patterns http://www.amazon.com/Implementation-Patterns-Addison-Wesley-Signature-Kent/dp/0321413091 Its got great ideas and the values and principles he states are great development perspectives to keep in mind while coding. I especially like the symmetry 'pattern' but they're all great advice. Code should communicate, be simple and flexible in that order. You should take a look at Kent Becks book Implementation Patterns http://www.amazon.com/Implementation-Patterns-Addison-Wesley-Signature-Kent/dp/0321413091

Its got great ideas and the values and principles he states are great development perspectives to keep in mind while coding.

I especially like the symmetry 'pattern' but they're all great advice. Code should communicate, be simple and flexible in that order.

]]> By: André Faria Gomes http://www.markhneedham.com/blog/2009/03/18/coding-make-it-obvious/comment-page-1/#comment-12590 André Faria Gomes Thu, 19 Mar 2009 01:21:59 +0000 http://www.markhneedham.com/blog/?p=1041#comment-12590 Very nice. It's like the KISS (Keep it Simple Stupid) Principle. Cheers! Very nice. It's like the KISS (Keep it Simple Stupid) Principle. Cheers!

]]> By: Software Quality Digest - 2009-03-18 | No bug left behind http://www.markhneedham.com/blog/2009/03/18/coding-make-it-obvious/comment-page-1/#comment-12579 Software Quality Digest - 2009-03-18 | No bug left behind Wed, 18 Mar 2009 20:46:05 +0000 http://www.markhneedham.com/blog/?p=1041#comment-12579 [...] Coding: Make it obvious - “One of the lessons that I’ve learned the more projects I work on is that the most important thing to do when coding is to do so in a way that you make life easier for the next person who has to come across that code, be it yourself or one of your team mates. I think the underlying idea is that we need to make things as obvious as possible.” [...] [...] Coding: Make it obvious – "One of the lessons that I've learned the more projects I work on is that the most important thing to do when coding is to do so in a way that you make life easier for the next person who has to come across that code, be it yourself or one of your team mates. I think the underlying idea is that we need to make things as obvious as possible." [...]

]]>