The Pragmatic Craftsman
:: Simplicity from complexity : by Stanley Kubasek ::
|
Home
|
About Me
«
Being More Productive
IT Employment On Upswing?
»
McConnell on Code Documentation
March 15th, 2005 |
In
Quotes
|
Comments Off
Good code is its own best documentation. As you’re about to add a comment, ask yourself, ‘How can I improve the code so that this comment isn’t needed?’ Improve the code and then document it to make it even clearer.
–Steve C McConnell
Share/Bookmark
See Also
» Ambler on Best Programmers
» Constant Change -- Beck
» Steve Jobs on Simplicity
» Do It Right -- Wooden
» Stas Kubasek on Learning New Technologies
Favorite Quote
Topics
Architecture / Design
(13)
Better Coder
(38)
Books
(58)
Books I Recommend
(26)
Career
(25)
Craftsmanship
(23)
Java
(23)
Learning / Thoughts
(19)
Quotes
(28)
Software Engineering
(4)
Uncategorized
(36)
Web Development
(4)
Tags
2010
2011
abstraction
advanced
Books
code
concepts
Craftsmanship
design patterns
encapsulation
goals
gof
grasp
immutability
innerclass
Java
javascript
jpa
learning
patterns
practicing
quality
Quotes
reading
recommended
reference
solid
tdd
testing
unclebob
Archive
January 2015
(1)
June 2013
(1)
September 2012
(1)
November 2011
(1)
October 2011
(1)
July 2011
(1)
May 2011
(1)
March 2011
(1)
February 2011
(2)
January 2011
(1)
November 2010
(1)
June 2010
(1)
...since January 2002
Currently Reading
Shelfari: Book reviews on your book blog
Object Oriented Reengineering Patterns (The Morgan Kaufmann...
by Serge Demeyer,...
Info
© 2001-2024 Stanley Kubasek
About me
::
Contact me
Me on Twitter
»see more
Recent Entries
The Software Craftsman
Write Debuggable Code!
Effective Programming: More Than Writing Code
Fundamentals of programming
Steve Jobs on Simplicity
Joining the TDD camp!
The Top 10 Attributes of a Great Programmer
The Boy Scout Rule
McConnell on Being Humble
Effective Java (2nd) – Must Read Book