Skip to content

Instantly share code, notes, and snippets.

@rkhmelyuk
Forked from soveran/elements.md
Created November 23, 2011 09:58
Show Gist options
  • Select an option

  • Save rkhmelyuk/1388310 to your computer and use it in GitHub Desktop.

Select an option

Save rkhmelyuk/1388310 to your computer and use it in GitHub Desktop.

Revisions

  1. rkhmelyuk revised this gist Nov 23, 2011. 1 changed file with 8 additions and 2 deletions.
    10 changes: 8 additions & 2 deletions elements.md
    Original file line number Diff line number Diff line change
    @@ -114,6 +114,12 @@

    57. Use feature flags.

    58. *Don't remove functionality, but add new and then test it's working better.* Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/
    58. Don't remove functionality, but add new and then test it's working better. *Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/*

    59. Use contract programming.
    59. Use contract programming.

    60. Write tests before coding for new features and libraries.

    61. Plan and design before coding.

    62. Read tutorial first.
  2. rkhmelyuk revised this gist Nov 23, 2011. 1 changed file with 1 addition and 2 deletions.
    3 changes: 1 addition & 2 deletions elements.md
    Original file line number Diff line number Diff line change
    @@ -114,7 +114,6 @@

    57. Use feature flags.

    58. Don't remove functionality, but add new and then test it's working better.
    Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/
    58. *Don't remove functionality, but add new and then test it's working better.* Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/

    59. Use contract programming.
  3. rkhmelyuk revised this gist Nov 23, 2011. 1 changed file with 1 addition and 2 deletions.
    3 changes: 1 addition & 2 deletions elements.md
    Original file line number Diff line number Diff line change
    @@ -115,7 +115,6 @@
    57. Use feature flags.

    58. Don't remove functionality, but add new and then test it's working better.

    Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/
    Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/

    59. Use contract programming.
  4. rkhmelyuk revised this gist Nov 23, 2011. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion elements.md
    Original file line number Diff line number Diff line change
    @@ -118,4 +118,4 @@

    Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/

    1. Use contract programming.
    59. Use contract programming.
  5. rkhmelyuk revised this gist Nov 23, 2011. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion elements.md
    Original file line number Diff line number Diff line change
    @@ -118,4 +118,4 @@

    Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/

    # Use contract programming.
    1. Use contract programming.
  6. rkhmelyuk revised this gist Nov 23, 2011. 1 changed file with 3 additions and 1 deletion.
    4 changes: 3 additions & 1 deletion elements.md
    Original file line number Diff line number Diff line change
    @@ -116,4 +116,6 @@

    58. Don't remove functionality, but add new and then test it's working better.

    Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/
    Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/

    # Use contract programming.
  7. rkhmelyuk revised this gist Nov 23, 2011. 1 changed file with 1 addition and 0 deletions.
    1 change: 1 addition & 0 deletions elements.md
    Original file line number Diff line number Diff line change
    @@ -115,4 +115,5 @@
    57. Use feature flags.

    58. Don't remove functionality, but add new and then test it's working better.

    Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/
  8. rkhmelyuk revised this gist Nov 23, 2011. 1 changed file with 2 additions and 3 deletions.
    5 changes: 2 additions & 3 deletions elements.md
    Original file line number Diff line number Diff line change
    @@ -1,4 +1,3 @@

    1. Write clearly – don't be too clever.

    2. Say what you mean, simply and directly.
    @@ -115,5 +114,5 @@

    57. Use feature flags.

    58. Don't remove functionality, but add new and then test it's working better
    http://altdevblogaday.com/2011/11/22/parallel-implementations/
    58. Don't remove functionality, but add new and then test it's working better.
    Maybe there is a change to extract functionality and use Strategy pattern to build a different implementations, and then apply each one to check what is the best. http://altdevblogaday.com/2011/11/22/parallel-implementations/
  9. rkhmelyuk revised this gist Nov 23, 2011. 1 changed file with 6 additions and 11 deletions.
    17 changes: 6 additions & 11 deletions elements.md
    Original file line number Diff line number Diff line change
    @@ -1,13 +1,3 @@
    ## The Elements of Programming Style

    The following rules of programming style are excerpted from the book "The
    Elements of Programming Style" by Kernighan and Plauger, published by McGraw
    Hill. Here is quote from the book: "To paraphrase an observation in The
    Elements of Style by Strunk and White, the rules of programming style, like
    those of English, are sometimes broken, even by the best writers. When a rule
    is broken, however, you will usually find in the program some compensating
    merit, attained at the cost of the violation. Unless you are certain of doing
    as well, you will probably do best to follow the rules."

    1. Write clearly – don't be too clever.

    @@ -121,4 +111,9 @@ as well, you will probably do best to follow the rules."

    55. Document your data layouts.

    56. Don't over-comment.
    56. Don't over-comment.

    57. Use feature flags.

    58. Don't remove functionality, but add new and then test it's working better
    http://altdevblogaday.com/2011/11/22/parallel-implementations/
  10. @soveran soveran created this gist Nov 18, 2011.
    124 changes: 124 additions & 0 deletions elements.md
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,124 @@
    ## The Elements of Programming Style

    The following rules of programming style are excerpted from the book "The
    Elements of Programming Style" by Kernighan and Plauger, published by McGraw
    Hill. Here is quote from the book: "To paraphrase an observation in The
    Elements of Style by Strunk and White, the rules of programming style, like
    those of English, are sometimes broken, even by the best writers. When a rule
    is broken, however, you will usually find in the program some compensating
    merit, attained at the cost of the violation. Unless you are certain of doing
    as well, you will probably do best to follow the rules."

    1. Write clearly – don't be too clever.

    2. Say what you mean, simply and directly.

    3. Use library functions whenever feasible.

    4. Avoid too many temporary variables.

    5. Write clearly – don't sacrifice clarity for "efficiency."

    6. Let the machine do the dirty work.

    7. Replace repetitive expressions by calls to common functions.

    8. Parenthesize to avoid ambiguity.

    9. Choose variable names that won't be confused.

    10. Avoid unnecessary branches.

    11. If a logical expression is hard to understand, try transforming it.

    12. Choose a data representation that makes the program simple.

    13. Write first in easy-to-understand pseudo language; then translate into
    whatever language you have to use.

    14. Modularize. Use procedures and functions.

    15. Avoid gotos completely if you can keep the program readable.

    16. Don't patch bad code – rewrite it.

    17. Write and test a big program in small pieces.

    18. Use recursive procedures for recursively-defined data structures.

    19. Test input for plausibility and validity.

    20. Make sure input doesn't violate the limits of the program.

    21. Terminate input by end-of-file marker, not by count.

    22. Identify bad input; recover if possible.

    23. Make input easy to prepare and output self-explanatory.

    24. Use uniform input formats.

    25. Make input easy to proofread.

    26. Use self-identifying input. Allow defaults. Echo both on output.

    27. Make sure all variable are initialized before use.

    28. Don't stop at one bug.

    29. Use debugging compilers.

    30. Watch out for off-by-one errors.

    31. Take care to branch the right way on equality.

    32. Be careful if a loop exits to the same place from the middle and the
    bottom.

    33. Make sure your code does "nothing" gracefully.

    34. Test programs at their boundary values.

    35. Check some answers by hand.

    36. 10.0 times 0.1 is hardly ever 1.0.

    37. 7/8 is zero while 7.0/8.0 is not zero.

    38. Don't compare floating point numbers solely for equality.

    39. Make it right before you make it faster.

    40. Make it fail-safe before you make it faster.

    41. Make it clear before you make it faster.

    42. Don't sacrifice clarity for small gains in "efficiency."

    43. Let your compiler do the simple optimizations.

    44. Don't strain to re-use code; reorganize instead.

    45. Make sure special cases are truly special.

    46. Keep it simple to make it faster.

    47. Don't diddle code to make it faster — find a better algorithm.

    48. Instrument your programs. Measure before making "efficiency" changes.

    49. Make sure comments and code agree.

    50. Don't just echo the code with comments — make every comment count.

    51. Don't comment bad code — rewrite it.

    52. Use variable names that mean something.

    53. Use statement labels that mean something.

    54. Format a program to help the reader understand it.

    55. Document your data layouts.

    56. Don't over-comment.