Please create an account to participate in the Slashdot moderation system

 



Forgot your password?
typodupeerror
Check out the new SourceForge HTML5 internet speed test! No Flash necessary and runs on all devices. Also, Slashdot's Facebook page has a chat bot now. Message it for stories and more. ×

Comment Architecture and Flow of Control comments (Score 1) 826

Far too late to join this conversation, but let me add my $0.02 anyway.

What I miss most in most source code are comments that communicate the architecture and flow of control at the module level. When you get the source code for a project, it's generally a flat list of files. Where do you start? main() is not always the right answer - what's needed is an overall look at the code base and a guide to how it was put together.

Comments in the source rarely address these questions, being more locally oriented as a rule.

Slashdot Top Deals

This is an unauthorized cybernetic announcement.

Working...