What is good code?
-
Slacker007 wrote:
someone who thinks they know what good code is
That's the key point. We all think we write good code. I can't imagine any professional programmer that would write bad code on purpose. There are people we use different naming conventions, different patterns or just plain old spaghetti code, but in the end, if the client is happy and the application works, it is not bad code. Could it be better? Probably and mostly, but in the end all these things are the programmers personal opinions. (eg. I can fix bugs in a matter of minutes in my own applications, but if you ask someone else to look at it, even if he knows the code very well, it will take longer, just because my mindset is different)
V.
-
Slacker007 wrote:
What is good code and what are the precise criteria for giving it a status of "good"?
There will never be any 'precise criteria' that will allow you to determine this.
Slacker007 wrote:
how do you know it is worth a damn, really?
Does it work? if not, it's worthless ... Is it readable, consistent and does it conform to common conventions? If not it will be a nightmare to pick up in a couple of years. How much time have you spent debugging your code? I think this is a good indicator, the less time you spend in the debugger the better the quality of the code. Is the important stuff testable, and do you have a good suite of tests for that? I think 80% of the tests I've seen does little more than test that the developer is not schizofrenic. Writing good tests is at least as hard as writing the other stuff. I prefer quality over quantity. Is it easy to debug? Complex expressions are harder to debug. By splitting them up into multiple expressions your code will be easier to debug.
Slacker007 wrote:
So who does?
Call in an external expert - preferably one who is well known for the quality of her/his work, and make it clear that you will not be offended when she/he has something less than favourable to say about your work. Done right this can be a great learning experience.
Espen Harlinn Principal Architect, Software - Goodtech Projects & Services AS My LinkedIn Profile
:thumbsup:
"the meat from that butcher is just the dogs danglies, absolutely amazing cuts of beef." - DaveAuld (2011)
"No, that is just the earthly manifestation of the Great God Retardon." - Nagy Vilmos (2011) "It is the celestial scrotum of good luck!" - Nagy Vilmos (2011) "But you probably have the smoothest scrotum of any grown man" - Pete O'Hanlon (2012) -
V. wrote:
but in the end, if the client is happy and the application works, it is not bad code
It may be ugly, though.
Veni, vidi, vici.
-
Who determines if your code is good? What is good code and what are the precise criteria for giving it a status of "good"? Since most of your code will never be reviewed by your peers (outside of work) then how do you know it is worth a damn, really? If I think your code sucks but the next guy thinks it is good, then who is right? This kind of goes in line with my other thoughts about the "greatness" of an individual programmer. Who determines that a person is a great programmer and that person writes some damn good code? You? Me? None of the above? We obviously cannot make this determination about ourselves or our code. So who does?
"the meat from that butcher is just the dogs danglies, absolutely amazing cuts of beef." - DaveAuld (2011)
"No, that is just the earthly manifestation of the Great God Retardon." - Nagy Vilmos (2011) "It is the celestial scrotum of good luck!" - Nagy Vilmos (2011) "But you probably have the smoothest scrotum of any grown man" - Pete O'Hanlon (2012)Good code above all, as several of the posters have already pointed to, is code that works as intended. I find the idea of people comparing their code masterpieces to paintings by great artists interesting. And indeed there is some beautiful code out there. However, if I hire painters to paint my house white, I don’t want a masterpiece that belongs in a museum, I want the white I paid the guy to paint. It should take at most a day or two to finish the job. I think the same holds true for a musical ensemble, all the parts need to work together and many of those parts are simple sequences. As a whole they make beautiful music. The band I’m in we’ve been auditioning for a fourth member, every one of them so far that have come have been very talented players, but having someone going “beadily-beadily- beadily-kerang!” over everything we play isn’t what we are looking for. We want a good utility player who can shine but not overpower or outshine everything we do. It makes for unlistenable music. Ultimately, the determination of good code is how the audience or customer perceives it. Is it useful? Does it do what they paid you to make it do? Do they want to come back for more?
It was broke, so I fixed it.
-
Good code above all, as several of the posters have already pointed to, is code that works as intended. I find the idea of people comparing their code masterpieces to paintings by great artists interesting. And indeed there is some beautiful code out there. However, if I hire painters to paint my house white, I don’t want a masterpiece that belongs in a museum, I want the white I paid the guy to paint. It should take at most a day or two to finish the job. I think the same holds true for a musical ensemble, all the parts need to work together and many of those parts are simple sequences. As a whole they make beautiful music. The band I’m in we’ve been auditioning for a fourth member, every one of them so far that have come have been very talented players, but having someone going “beadily-beadily- beadily-kerang!” over everything we play isn’t what we are looking for. We want a good utility player who can shine but not overpower or outshine everything we do. It makes for unlistenable music. Ultimately, the determination of good code is how the audience or customer perceives it. Is it useful? Does it do what they paid you to make it do? Do they want to come back for more?
It was broke, so I fixed it.
S Houghtelin wrote:
I think the same holds true for a musical ensemble
A musical ensemble spends a lot of time practising, how many developers does that at all?
Espen Harlinn Principal Architect, Software - Goodtech Projects & Services AS My LinkedIn Profile
-
Good code above all, as several of the posters have already pointed to, is code that works as intended. I find the idea of people comparing their code masterpieces to paintings by great artists interesting. And indeed there is some beautiful code out there. However, if I hire painters to paint my house white, I don’t want a masterpiece that belongs in a museum, I want the white I paid the guy to paint. It should take at most a day or two to finish the job. I think the same holds true for a musical ensemble, all the parts need to work together and many of those parts are simple sequences. As a whole they make beautiful music. The band I’m in we’ve been auditioning for a fourth member, every one of them so far that have come have been very talented players, but having someone going “beadily-beadily- beadily-kerang!” over everything we play isn’t what we are looking for. We want a good utility player who can shine but not overpower or outshine everything we do. It makes for unlistenable music. Ultimately, the determination of good code is how the audience or customer perceives it. Is it useful? Does it do what they paid you to make it do? Do they want to come back for more?
It was broke, so I fixed it.
-
S Houghtelin wrote:
I think the same holds true for a musical ensemble
A musical ensemble spends a lot of time practising, how many developers does that at all?
Espen Harlinn Principal Architect, Software - Goodtech Projects & Services AS My LinkedIn Profile
Espen Harlinn wrote:
A musical ensemble spends a lot of time practising, how many developers does that at all?
If you code for a living, the practice is from the experience you gain from coding every day. You may be right, I've seen some examples of those who don't appear to code very often... ;)
It was broke, so I fixed it.
-
CPallini wrote:
It may be ugly, though.
To you and/or to me, but is it bad then? You'd probably think I wrote bad code as well. The more two programmers 'think/write' alike, the more they think of each other as good programmers. :)
V.
-
Espen Harlinn wrote:
A musical ensemble spends a lot of time practising, how many developers does that at all?
If you code for a living, the practice is from the experience you gain from coding every day. You may be right, I've seen some examples of those who don't appear to code very often... ;)
It was broke, so I fixed it.
S Houghtelin wrote:
the practice is from the experience you gain from coding every day
This works well up to a certain limit, to go beyond that I think you have to start practicing ...
Espen Harlinn Principal Architect, Software - Goodtech Projects & Services AS My LinkedIn Profile
-
If the code works as designed, it's good.
".45 ACP - because shooting twice is just silly" - JSOP, 2010
-----
You can never have too much ammo - unless you're swimming, or on fire. - JSOP, 2010
-----
"Why don't you tie a kerosene-soaked rag around your ankles so the ants won't climb up and eat your candy ass." - Dale Earnhardt, 1997John Simmons / outlaw programmer wrote:
If the code works as designed
Have you seen code that doesn't work as designed?
Espen Harlinn Principal Architect, Software - Goodtech Projects & Services AS My LinkedIn Profile
-
SSEAR wrote:
Both code will work as it designed for. But which one is the best code?
Ah! There in lies the question. If both work as designed, does it really matter, and whom does it matter too? ;)
"the meat from that butcher is just the dogs danglies, absolutely amazing cuts of beef." - DaveAuld (2011)
"No, that is just the earthly manifestation of the Great God Retardon." - Nagy Vilmos (2011) "It is the celestial scrotum of good luck!" - Nagy Vilmos (2011) "But you probably have the smoothest scrotum of any grown man" - Pete O'Hanlon (2012) -
Who determines if your code is good? What is good code and what are the precise criteria for giving it a status of "good"? Since most of your code will never be reviewed by your peers (outside of work) then how do you know it is worth a damn, really? If I think your code sucks but the next guy thinks it is good, then who is right? This kind of goes in line with my other thoughts about the "greatness" of an individual programmer. Who determines that a person is a great programmer and that person writes some damn good code? You? Me? None of the above? We obviously cannot make this determination about ourselves or our code. So who does?
"the meat from that butcher is just the dogs danglies, absolutely amazing cuts of beef." - DaveAuld (2011)
"No, that is just the earthly manifestation of the Great God Retardon." - Nagy Vilmos (2011) "It is the celestial scrotum of good luck!" - Nagy Vilmos (2011) "But you probably have the smoothest scrotum of any grown man" - Pete O'Hanlon (2012)Good code is fit for purpose. Of course the first idea of fit for purpose is that it fulfills the functional requirements and doesn't break the nonfunctional criteria. But as, or more, important might be maintainability. Commenting, clean object orientation and layering of library code might be more important than execution efficiency. Consider whether your project might live long, and might get maintained by several people, and whether those people will be with the project long enough to learn all its pitfalls or whether they will be temporary hires to fix up and add functionality. These factors affect how important documentation, naming conventions and avoiding optimizations that make the code hard to read. In the project I'm working on,good code is code that is tested, where the tests are marked up with requirements tracing so we can see who asked for the functionality and in what context. Then we can retire unwanted functionality which allows refactoring. Without that, we can't touch code in case we break something that some user relies on.
-
Who determines if your code is good? What is good code and what are the precise criteria for giving it a status of "good"? Since most of your code will never be reviewed by your peers (outside of work) then how do you know it is worth a damn, really? If I think your code sucks but the next guy thinks it is good, then who is right? This kind of goes in line with my other thoughts about the "greatness" of an individual programmer. Who determines that a person is a great programmer and that person writes some damn good code? You? Me? None of the above? We obviously cannot make this determination about ourselves or our code. So who does?
"the meat from that butcher is just the dogs danglies, absolutely amazing cuts of beef." - DaveAuld (2011)
"No, that is just the earthly manifestation of the Great God Retardon." - Nagy Vilmos (2011) "It is the celestial scrotum of good luck!" - Nagy Vilmos (2011) "But you probably have the smoothest scrotum of any grown man" - Pete O'Hanlon (2012)I go the other way, I know when code is crappy. Mind you crappy code tends to appear whenever I look at old applications, the more you learn the better your code should be. If it does the job and I like the way it does the job then AFAIAC it is good code.
Never underestimate the power of human stupidity RAH
-
John Simmons / outlaw programmer wrote:
If the code works as designed
Have you seen code that doesn't work as designed?
Espen Harlinn Principal Architect, Software - Goodtech Projects & Services AS My LinkedIn Profile
-
If the code works as designed, it's good.
".45 ACP - because shooting twice is just silly" - JSOP, 2010
-----
You can never have too much ammo - unless you're swimming, or on fire. - JSOP, 2010
-----
"Why don't you tie a kerosene-soaked rag around your ankles so the ants won't climb up and eat your candy ass." - Dale Earnhardt, 1997 -
Who determines if your code is good? What is good code and what are the precise criteria for giving it a status of "good"? Since most of your code will never be reviewed by your peers (outside of work) then how do you know it is worth a damn, really? If I think your code sucks but the next guy thinks it is good, then who is right? This kind of goes in line with my other thoughts about the "greatness" of an individual programmer. Who determines that a person is a great programmer and that person writes some damn good code? You? Me? None of the above? We obviously cannot make this determination about ourselves or our code. So who does?
"the meat from that butcher is just the dogs danglies, absolutely amazing cuts of beef." - DaveAuld (2011)
"No, that is just the earthly manifestation of the Great God Retardon." - Nagy Vilmos (2011) "It is the celestial scrotum of good luck!" - Nagy Vilmos (2011) "But you probably have the smoothest scrotum of any grown man" - Pete O'Hanlon (2012)Good code can be understood and modified by other developers. Good code is modular enough, but not too much, such that when change requests come it is usually not a major rewrite.
There are only 10 types of people in the world, those who understand binary and those who don't.
-
I go the other way, I know when code is crappy. Mind you crappy code tends to appear whenever I look at old applications, the more you learn the better your code should be. If it does the job and I like the way it does the job then AFAIAC it is good code.
Never underestimate the power of human stupidity RAH
Mycroft Holmes wrote:
whenever I look at old applications
Exactly. Right now, someone says their code is good. 2 years later, it's crappy. You learn and you get better.
"the meat from that butcher is just the dogs danglies, absolutely amazing cuts of beef." - DaveAuld (2011)
"No, that is just the earthly manifestation of the Great God Retardon." - Nagy Vilmos (2011) "It is the celestial scrotum of good luck!" - Nagy Vilmos (2011) "But you probably have the smoothest scrotum of any grown man" - Pete O'Hanlon (2012) -
Espen Harlinn wrote:
Have you seen code that doesn't work as designed?
All the time.
Veni, vidi, vici.
I think I'll have to modify this one to: Assuming that compilers, interpreters and hardware works as expected, have you ever seen code that doesn't work as designed? ( Think about what code really is ... )
Espen Harlinn Principal Architect, Software - Goodtech Projects & Services AS My LinkedIn Profile
-
I think I'll have to modify this one to: Assuming that compilers, interpreters and hardware works as expected, have you ever seen code that doesn't work as designed? ( Think about what code really is ... )
Espen Harlinn Principal Architect, Software - Goodtech Projects & Services AS My LinkedIn Profile
-
Slacker007 wrote:
Who determines if your code is good?
First, I do. After 30 years in this business, I know when I've done a good job and when I haven't. Second, I work with a team of other developers on our product. They aren't shy when they find a bug in my stuff. Third, we have a test group. One of them is actually 'embedded' in our department full-time. 'Marcia the Test Terrier' is relentless. Fourth, field service. Our service guys are also not shy about bugs. They also have direct access to our two bug reporting systems (one is for development issues, the other for customer issues). Finally, customers. They've spent from $1.5M to $5M on our product. They have certain... expectations.
Slacker007 wrote:
What is good code and what are the precise criteria for giving it a status of "good"?
Good code satisfies the customers' needs without undue cost. For the developers on my team, it means they don't have to jump through hoops to interface to my part of the product. For testers, they can perform meaningful, repeatable tests and easily report successes and failures. The service guys want the software to help them diagnose hardware problems (our product is a large printing press) and not get in their way. The customer wants the software to print, and wants to be able to have a lightly-trained monkey able to operate the machine. You can see that these 'customers' all have different needs, some of which conflict with each other.
Slacker007 wrote:
Since most of your code will never be reviewed by your peers (outside of work) then how do you know it is worth a damn, really?
See my answer to your first question. There are lots of people to tell me when my code sucks. Relatively little positive feedback comes back. Occasionally Marcia the Test Terrier tells me she likes a new feature. The service guys will also come across with an 'about time you guys did this'. I only talk to customers directly on rare occasions, so I don't hear much from them. Objectively my code is somewhat old-fashioned. While I do tend to implement 'patterns' as defined by the Gang of Four, I'm not as formal about it. I've written code that used those patterns when the book authors were in diapers. Some of my code exhibits anti-pattern or 'code smells' that are presently deprecated. For example, I use underscores in names occasionally. It still works.
This so spot on. Good code is in part measured by how it is used. I don't often bookmark posts, but I did yours. It needs to be re-iterated every time someone asks again about code quality and how to determine it. :)
Chris Meech I am Canadian. [heard in a local bar] In theory there is no difference between theory and practice. In practice there is. [Yogi Berra] posting about Crystal Reports here is like discussing gay marriage on a catholic church’s website.[Nishant Sivakumar]