View Single Post
Posts: 263 | Thanked: 77 times | Joined on Jan 2009 @ Sigtuna, Sweden
#31
Originally Posted by attila77 View Post
Just as a reference, ohloh has (an automatic) project analysis feature. Based on the specified source (you just specify a SCM), it takes a look and displays some info about it. For example, pidgin. Not saying it should be done in the same way, just saying that OSS project analysis is not a completely uncharted territory
I suppose that migh work about as well as grammer checking in a word processor.
It has benefits - and dangers, especially if the organization around pushes for compliance; then the result is often bad prose.

Good programming is (as writing) about well structured thinking.
Automatic checking might help having details well documented.

But the kind of code commenting and documentation I have in mind,
which helps the programmer to structure his thoughts and vision,
and also increases code maintainability,
can only be encouraged by human help.

EDIT :
I answered before reading your links.
Good !
Any structure that helps us humans
communicate efficiently,
helps here !

Last edited by KristianW; 2009-08-16 at 12:16.