You can go back and forth about which is more important - the code or the comments - but why not harness the capacities of modern programming languages to achieve both? Expressive programming. Well-planned naming conventions and code organization can speak volumes more (and quicker) than the mini whitepapers that often preface blocks of unintuitive code. If the variable 'i' is the current index in the collection, why not just call it 'collectionIndex' afterall?
At the risk of falling back on cliche, all we've got is word of mouth. I'm not convinced any single source browser will ever hit the mainstream, but I'm pretty sure that *if* one does, props will be given to 'word of mouth'.
Get your parents, friends, and girlfriends on it. They'll trust you before they'll trust some cheesy MSN ad. (Here's to hoping, anyway..)
You can go back and forth about which is more important - the code or the comments - but why not harness the capacities of modern programming languages to achieve both? Expressive programming. Well-planned naming conventions and code organization can speak volumes more (and quicker) than the mini whitepapers that often preface blocks of unintuitive code. If the variable 'i' is the current index in the collection, why not just call it 'collectionIndex' afterall?
At the risk of falling back on cliche, all we've got is word of mouth. I'm not convinced any single source browser will ever hit the mainstream, but I'm pretty sure that *if* one does, props will be given to 'word of mouth'. Get your parents, friends, and girlfriends on it. They'll trust you before they'll trust some cheesy MSN ad. (Here's to hoping, anyway..)