Home AMX User Forum AMX General Discussion

General Discussion: Ten Commandants of Coding

I think there's a lot to be learned here, and I'm really trying to adhere to these. I particularly like number 1-4 and number 10, especially for a forum setting, such as here. Though I may not follow these every day, I will surely make an effort from now on.

1. Understand and accept that you will make mistakes. The point is to find them early, before they make it into production. Fortunately, except for the few of us developing rocket guidance software at JPL, mistakes are rarely fatal in our industry, so we can, and should, learn, laugh, and move on.

2. You are not your code. Remember that the entire point of a review is to find problems, and problems will be found. Don't take it personally when one is uncovered.

3. No matter how much "karate" you know, someone else will always know more. Such an individual can teach you some new moves if you ask. Seek and accept input from others, especially when you think it's not needed.

4. Don't rewrite code without consultation. There's a fine line between "fixing code" and "rewriting code." Know the difference, and pursue stylistic changes within the framework of a code review, not as a lone enforcer.

5. Treat people who know less than you with respect, deference, and patience. Nontechnical people who deal with developers on a regular basis almost universally hold the opinion that we are prima donnas at best and crybabies at worst. Don't reinforce this stereotype with anger and impatience.

6. The only constant in the world is change. Be open to it and accept it with a smile. Look at each change to your requirements, platform, or tool as a new challenge, not as some serious inconvenience to be fought.

7. The only true authority stems from knowledge, not from position. Knowledge engenders authority, and authority engenders respect?so if you want respect in an egoless environment, cultivate knowledge.

8. Fight for what you believe, but gracefully accept defeat. Understand that sometimes your ideas will be overruled. Even if you do turn out to be right, don't take revenge or say, "I told you so" more than a few times at most, and don't make your dearly departed idea a martyr or rallying cry.

9. Don't be "the guy in the room." Don't be the guy coding in the dark office emerging only to buy cola. The guy in the room is out of touch, out of sight, and out of control and has no place in an open, collaborative environment.

10. Critique code instead of people?be kind to the coder, not to the code. As much as possible, make all of your comments positive and oriented to improving the code. Relate comments to local standards, program specs, increased performance, etc.

-Jerry Weinberg, The The Psychology of Computer Programming

Comments

  • mpullinmpullin Posts: 949
    #3 would make more sense if it referred to "kung foo( )"
  • yuriyuri Posts: 861
    mpullin wrote:
    #3 would make more sense if it referred to "kung foo( )"

    hence the double quotes ;)
  • pdabrowskipdabrowski Posts: 184
    Reading this reminds me how much I value the working relationship I have with our main subcontractor.

    @amx_programmers can you make that a part of the EULA for Studio :D
  • Spire_JeffSpire_Jeff Posts: 1,917
    9. Don't be "the guy in the room." Don't be the guy coding in the dark office emerging only to buy cola. The guy in the room is out of touch, out of sight, and out of control and has no place in an open, collaborative environment.

    Hey, I resemble... err I mean resent that! ;)

    Altho, I am in complete control and I can stop any time I want to.... I just choose not to.

    Jeff
  • jjamesjjames Posts: 2,908
    I made a slight mistake; this "article" was titled, "Ten Commandmants of Egoless Programming".
  • Chip MoodyChip Moody Posts: 727
    Amen, Jeff.

    And #7 would be easier to appreciate if we lived in a world where people without knowledge were prevented from attaining position... :(

    Spire_Jeff wrote:
    Altho, I am in complete control and I can stop any time I want to.... I just choose not to.

    Jeff
  • Thomas HayesThomas Hayes Posts: 1,164
    Chip Moody wrote:
    Amen, Jeff.

    And #7 would be easier to appreciate if we lived in a world where people without knowledge were prevented from attaining position... :(

    How true Chip. I remember a number of years back and federal minister's chief of multimedia telling we didn't know what we were doing, turns out that a week before he was the minister's personel chef-must of made a great salad ;)
  • Chip MoodyChip Moody Posts: 727
    ...turns out that a week before he was the minister's personel chef-must of made a great salad ;)

    That's effing brilliant. :) Thanks for sharing...

    - Chip
Sign In or Register to comment.