VaultNetwork.net Vault Network Boards
Author Topic: For my fellow programmers [Locked]
Arc_DT  2 stars
Title: Mithan said I am smart
Posts: 363
Registered: 2002-5-28 08:25:51
the_great_intex posted:

I never, ever comment my code


To good code, comments are a detriment. Good code uses meaningful labels and small blocks where the code itself is the comments.

With that said, I split interfaces from implementation and comment the *interface*, because that's what's going to be consumed by other programmers, and also what I'm going to forget when I come back months or years later. Macro-level comments = good, micro-level comments = bad, unless there's simply no practical way to make obvious what it is you're doing without the comment.

 

-----signature-----
"... We just need a president to sign this stuff... Pick a Republican with enough working digits to handle a pen to become president."
-Grover Norquist
.
MICHIGAN - Where the trees are the right height!
Immortal_Haze  2 stars
Posts: 498
Registered: 2002-1-31 17:54:09
I've identified 3 people in this thread I'd never want to work with already... jeez.

BTW, Lan, my whole job for about 6 years has been fixing other peoples' sh*t code. :\

 

-----signature-----

"Those who have long enjoyed such privileges as we
enjoy forget in time that men have died to win them." FDR
TheUnholyGhost  2 stars
Title: Mr. Subtle
Posts: 271
Registered: 2000-4-4 13:21:40
LOL Programmers


/end BT

 

-----signature-----
The Ghost
Ryan Giggs, the Legend: http://www.youtube.com/watch?v=3GxhYklM_3M
Glory Glory Man United: http://www.youtube.com/watch?v=V6WuMtdMVq8
Ex-remlocke  1 star
Posts: 131
Registered: 2000-5-12 14:52:25
-Accident- posted:

Rhodoman posted:

Some of it is also because, even if you talk your project management into writing down requirements and specifications, they are rarely adhered to, constantly changing and increasing until the project just barely launches within its time frame and you have spent all your time making sure the damn thing works, doesn't crash and does every extra damn thing they asked for at the last minute.

So there's no time or money left to explain how you actually got it accomplished.


Rho



not using Agile, eh?



switching from pure waterfall to an agile/waterfall mix was the best thing our team has ever done.

 

-----signature-----
this.
what the **** is a Barack?! - DMX
Immortal_Haze  2 stars
Posts: 498
Registered: 2002-1-31 17:54:09
Ex-remlocke posted:

switching from pure waterfall to an agile/waterfall mix was the best thing our team has ever done.



I need you to come talk to some of the old fogies here lol. The comment I made earlier this week to a technical fellow... "After 8 years of doing the same process, we're expecting different results this time? We don't want to risk changing the process but would rather fail again using business as usual?"

 

-----signature-----

"Those who have long enjoyed such privileges as we
enjoy forget in time that men have died to win them." FDR
Unarmed-Yarr  2 stars
Title: Pirate of Harrrvestgain
Posts: 390
Registered: 2000-2-23 15:43:24
haha, love it

 

-----signature-----
Old Fogie (4,297 days old), East Sider, Pirate
Unarmed Yarr, Dissilspilg, HOH 4 life (12-15-00)
Passersby were amazed by the unusually large amounts of blood.
meltedmossy  1 star
Title: :(){ :|:& };:
Posts: 156
Registered: 2001-8-12 13:55:41
silvadel2 posted:

This is yet another reason why I like pascal-languages more than c-languages... It is FAR easier to self-comment pascal than C.

C is the reason for all the mess...

I do not understand why mainstream coding has not moved on by now.

We no longer live in a "closest to the metal and portability of the language are of massive importance" world...

We live in a "ease of debugging and ease of maintaining code SHOULD be the primary concern but ISNT" world.


Have you ever heard of embedded devices? Kernel programming? Writing GPU code?

 

-----signature-----
Spirits Within.
Mage, 150.
Slumbering away the days for now..
i have the damn ass patron
silvadel2  2 stars
Posts: 378
Registered: 2009-7-13 09:37:29
meltedmossy posted:

silvadel2 posted:

This is yet another reason why I like pascal-languages more than c-languages... It is FAR easier to self-comment pascal than C.

C is the reason for all the mess...

I do not understand why mainstream coding has not moved on by now.

We no longer live in a "closest to the metal and portability of the language are of massive importance" world...

We live in a "ease of debugging and ease of maintaining code SHOULD be the primary concern but ISNT" world.


Have you ever heard of embedded devices? Kernel programming? Writing GPU code?



Sure -- it is called assembly language.

 

-----signature-----
Lost postcount 17k; Lost years 9.6; Lost Title: Priceless
The most expensive things in life are free
Asheron's Call 3 // Horizons 2 -- Dragons of Dereth (one can always hope)
1920x1200 is a Monitor. 1920x1080 is a TV without a tuner.
Arc_DT  2 stars
Title: Mithan said I am smart
Posts: 363
Registered: 2002-5-28 08:25:51
//Inserts bread into each container
for(cc=fc;cc<=lc;cc++)
c[cc].push(br);


...


//Do I really need a comment?
for(currentContainer=firstContainer; currentContainer<=lastContainer; currentContainer++)
containers[currentContainer].insert(bread);


...


//But comment the interface
void putBreadInIt(Bread bread, ContainerArray containers, int firstContainer, int lastContainer);//Puts bread into each container

 

-----signature-----
"... We just need a president to sign this stuff... Pick a Republican with enough working digits to handle a pen to become president."
-Grover Norquist
.
MICHIGAN - Where the trees are the right height!
ACX  1 star
Posts: 248
Registered: 2001-10-25 12:53:52
I never realized so much of ACF was programmers.

VaultNetwork.net is an independently operated community forum and is not affiliated with, endorsed by, or technically based on IGN, GameSpy, FilePlanet, GameStats, or the former IGN/GameSpy Vault Network.
References to VaultNetwork.net mean this site/domain. VNBoards-style presentation is a visual homage only. By using this site, you agree to the forum rules.