CommentYourCode

 

Sudden epiphany:

Wiki is like commenting your code!

Good programmers take the time to annotate software as they develop it. Comments make a complex algorithm understandable and a data structure transparent. Later, when it's necessary to fix or extend a program, comments pay for themselves a hundredfold in efficiency and accuracy, both for the original author and for anyone else involved.

Just so, time spent building a network of wiki pages is an investment in documenting the structures and relationships among ideas...


TopicProgramming - TopicThinking - 2007-09-19



(correlates: PreemptiveDisclosure, ShortTimers, OrchardOfThoughts, ...)