mgttrottier:
The comments help keep me organized as I am a beginner but I do get what you mean.
Comments are great. Definitely use lots of comments. But you wouldn't want to have the same comment explaining what a variable is for everywhere you use it, that's why you should use descriptive variable names so you don't have to think for a second "Now which color was A?".
CrossRoads:
or a flatter top,
LED - RGB Addressable, PTH, 5mm Clear (5 Pack) - COM-12999 - SparkFun Electronics
I like that "straw hat" style of LED but I think a bare non-diffused LED would be confusing because you still see too much of each individual color. If there will be some external diffuser added that would be fine (you still don't get as good of color mixing in my experience but it's not too bad) but I haven't read anything here about a diffuser.