Code Commentary - Collin’s Lab Notes #adafruit #collinslabnotes

Get great boards to code for @ Adafruit:

Commenting your code does more than just add a human touch – still , that’s big part of it :) #adafruit #collinslabnotes

-----------------------------------------

-----------------------------------------

[blic-sxix]

I agree wholeheartedly! I comment for me. I used to think "oh ill remember why I did that". Later I am scratching my head thinking "why did I do that!"

[fecheverria]

I had to look up this video on YT to thumb up, adafruit blog blocks redirection to YT.

[Wayko]

I use the story design programming. IE As a user I would like to be able to to do, ,,

[connormccarter]

I've used the "fill out the outline" method a few times. Also I like to leave a big block of comment as instructions on how to use a particularly tough function or functions that take an unreasonable amount of options... Like object creation for AutoCAD with lisp routines... Thanks Collin!

[secretivesquirrelstudios]

When I was in university I got marked down for writing excessive comments/notes instead of just writing the bare essentials and no more. The irony being that when people got badly stuck in one project, the tutor used part of my code to explain what was happening to the class.
When I pointed out they'd marked me down for the exact part they used to teach the class I wound up having my marks revisited.
Man I hated Uni.

[MichaelSheldon]

It only takes opening up a chunk of code you wrote a few years back to see the value in commenting. Nothing will get you cursing out yourself like opening a huge block of uncommented code, and having no memory at all of what you were thinking.
Also a big fan of writing comment outlines, then filling in with code. Reduces the number of times I have to refactor a large chunk of code into smaller functions.

[PatrickPoet]

Thank you. There's a recent fad in coding to disparage commenting. Weird.

[cashgarman]

I've been using top-down coding (reverse-commenting as you call it) since I was a young coder, and try to instill the same practice in my students now I'm an old coder. Shout out to all those careful commenters out there. Thank you.

[Doping]

Amazing how much useful practical stuff you can jam into such short videos. Awesome series!