Click here to Skip to main content
15,867,568 members

Welcome to the Lounge

   

For discussing anything related to a software developer's life but is not for programming questions. Got a programming question?

The Lounge is rated Safe For Work. If you're about to post something inappropriate for a shared office environment, then don't post it. No ads, no abuse, and no programming questions. Trolling, (political, climate, religious or whatever) will result in your account being removed.

 
GeneralRe: Kicking the Can Down the Road Pin
#realJSOP3-Mar-21 2:29
mve#realJSOP3-Mar-21 2:29 
GeneralRe: Kicking the Can Down the Road Pin
Jacquers2-Mar-21 0:38
Jacquers2-Mar-21 0:38 
GeneralRe: Kicking the Can Down the Road Pin
Maximilien2-Mar-21 2:06
Maximilien2-Mar-21 2:06 
GeneralRe: Kicking the Can Down the Road Pin
raddevus2-Mar-21 2:43
mvaraddevus2-Mar-21 2:43 
GeneralRe: Kicking the Can Down the Road Pin
honey the codewitch2-Mar-21 3:48
mvahoney the codewitch2-Mar-21 3:48 
GeneralRe: Kicking the Can Down the Road Pin
#realJSOP2-Mar-21 5:10
mve#realJSOP2-Mar-21 5:10 
GeneralRe: Kicking the Can Down the Road Pin
honey the codewitch2-Mar-21 5:14
mvahoney the codewitch2-Mar-21 5:14 
GeneralRe: Kicking the Can Down the Road Pin
#realJSOP2-Mar-21 5:29
mve#realJSOP2-Mar-21 5:29 
If I was tasked with actually implementing a given piece of code, the commenting wouldn't be nearly as heavy as it is in this case. I'd put in intellisense for method/property prototypes and mostly leave it at that, and maybe a sufficiently descriptive narrative comment at the top of the file if the code task involves creating a moderately complex class. This particular code is unique, because it wasn't tasked, or even outright requested. I did it because there was a perceived need (truthfully, I identified the need three years ago), and I like to solve problems with code.

I know the kinds of questions the other devs on the team will ask, and I hate having to re-explain stuff verbally, so what/why comments serve that role, and in this case, I actually had to back-up my thought processes.

I'm not actually offended, I'm just old and set in my ways.

BTW, I also tend to "over-comment" code I write for CP articles. In my most recent one, I actually included the recommended implementation of an interface as a comment block because people using the code may not recall where they got it, and it's nice to have info when you're re-implementing it blind and with no backward reference material.
".45 ACP - because shooting twice is just silly" - JSOP, 2010
-----
You can never have too much ammo - unless you're swimming, or on fire. - JSOP, 2010
-----
When you pry the gun from my cold dead hands, be careful - the barrel will be very hot. - JSOP, 2013

GeneralRe: Kicking the Can Down the Road Pin
honey the codewitch2-Mar-21 7:24
mvahoney the codewitch2-Mar-21 7:24 
GeneralRe: Kicking the Can Down the Road Pin
NightPen3-Mar-21 6:45
NightPen3-Mar-21 6:45 
GeneralRe: Kicking the Can Down the Road Pin
#realJSOP3-Mar-21 7:01
mve#realJSOP3-Mar-21 7:01 
GeneralRe: Kicking the Can Down the Road Pin
NightPen3-Mar-21 14:17
NightPen3-Mar-21 14:17 
GeneralRe: Kicking the Can Down the Road Pin
pkfox5-Mar-21 2:00
professionalpkfox5-Mar-21 2:00 
GeneralRe: Kicking the Can Down the Road Pin
#realJSOP5-Mar-21 2:44
mve#realJSOP5-Mar-21 2:44 
GeneralRe: Kicking the Can Down the Road Pin
NightPen5-Mar-21 7:57
NightPen5-Mar-21 7:57 
GeneralRe: Kicking the Can Down the Road Pin
pkfox5-Mar-21 10:15
professionalpkfox5-Mar-21 10:15 
GeneralRe: Kicking the Can Down the Road Pin
Rick York2-Mar-21 6:14
mveRick York2-Mar-21 6:14 
GeneralRe: Kicking the Can Down the Road Pin
#realJSOP2-Mar-21 7:17
mve#realJSOP2-Mar-21 7:17 
GeneralRe: Kicking the Can Down the Road Pin
Rick York2-Mar-21 8:02
mveRick York2-Mar-21 8:02 
GeneralRe: Kicking the Can Down the Road Pin
pkfox5-Mar-21 10:16
professionalpkfox5-Mar-21 10:16 
GeneralRe: Kicking the Can Down the Road Pin
DerekT-P2-Mar-21 6:55
professionalDerekT-P2-Mar-21 6:55 
GeneralNever, Never say 'I know a bit about that' in a stand up Pin
glennPattonWork31-Mar-21 22:40
professionalglennPattonWork31-Mar-21 22:40 
GeneralRe: Never, Never say 'I know a bit about that' in a stand up Pin
Johnny J.2-Mar-21 0:53
professionalJohnny J.2-Mar-21 0:53 
GeneralRe: Never, Never say 'I know a bit about that' in a stand up Pin
20212a2-Mar-21 1:13
20212a2-Mar-21 1:13 
GeneralRe: Never, Never say 'I know a bit about that' in a stand up Pin
glennPattonWork32-Mar-21 1:35
professionalglennPattonWork32-Mar-21 1:35 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.