No I’m not dead. Yes I haven’t updated this in an age (well maybe not that long it’s only been… oh wow…). What have I been doing in the time since I last made a post? Well Skyrim mainly.
Anyway we’re back at it again with new coursework, deadlines, work and all that it entails. Here’s a little something I have to work on, most of the code is kindly provided and i just need to take what I need and apply it correctly (yay for learning). But what’s with all the green text? Comments. Little nuggets of wisdom that I as a Developer need to leave for the far future when some new Dev. looks over my code and tries to work out just what the hell I’m doing. They’re supposed to be little explanations to help with that. But really I just want to drop lots of sarcastic comments in because if you can’t work out that the AddCompetitor method is going to ‘ADD’ a ‘COMPETITOR’ to the array/list/dictionary but it will require you to provide a ‘NAME’ and ‘ADDRESS’ then clearly there’s a language barrier that I’m not aware of.
Yes it may seem like I’m ranting on that but this is part of my problem with commenting code: I just don’t know what is appropriate. Do I comment every variable with an explanation of what it is (string CompetitorName ///the Name of the Competitor) even when it’s obvious what they’re for? Same with methods, I have one called FindCompetitor, but do I really need to comment and tell you that this is a searching method? Or what it is that it will look for and find? Are you actually unable to work that out?
Then again I could just include a recipe for chicken soup.