Jangla
26 Mar 2009, 2:04 AM
Hi. Can I make one small request when it comes to posting tutorials and examples? Comment your code a LOT more. Even the simplest examples here have dozens of lines of code and almost no commenting. I know there's text outside the code blocks but this is invariably cluttered with unnecessary jargon and doesn't actually explain why anything is done - it just tells you that something is being done. Case in point - the BoxComponent example; nearly 100 lines of code and not one single comment.
Sure, I can understand that people get tired of providing n00bs with spoon-fed information but the fact is that if you don't comment your code to show why you're doing something then this issue will perpetuate and no-one will learn anything; they'll just plagiarise very similar examples and change tiny elements of it to suit their needs.
Like it or not, the internet is full of people of all sorts of abilities - everyone has to start somewhere. My ethos has always been that skill level should not be a hindrance to progression - passion to learn is key. But if there's no-one willing to show why things are done a certain way that passion can be damped or completely die and opportunities to shine are missed.
Just my 2 cents. Rant over.
Sure, I can understand that people get tired of providing n00bs with spoon-fed information but the fact is that if you don't comment your code to show why you're doing something then this issue will perpetuate and no-one will learn anything; they'll just plagiarise very similar examples and change tiny elements of it to suit their needs.
Like it or not, the internet is full of people of all sorts of abilities - everyone has to start somewhere. My ethos has always been that skill level should not be a hindrance to progression - passion to learn is key. But if there's no-one willing to show why things are done a certain way that passion can be damped or completely die and opportunities to shine are missed.
Just my 2 cents. Rant over.