Improve comments in Color documentation

[aaronfranke]

Fixes. #42707. EDIT: This is now a subset of what it used to be, due to some of the constructor methods being temporarily removed. I will update this PR if they are added back first, or otherwise I will make a follow-up after they are added back.

Two main problems:

• The comments referenced RGBA and HSV as if they were methods, but they are not.

• The comments used 0-255 notation pretty much everywhere, which is not the typical way Godot colors are represented.

I fixed both of these problems by replacing comments with valid code examples required to reproduce the colors. In most places prefer the normal Color constructor, but in a few places show how it compares with Color8. For from_hsv specifically, explain in detail what's going on, since it may not be obvious otherwise. Also be specific about whether an example is equivalent to or just similar to, since in many cases the colors are not exactly the same.

All the comments should be valid code examples now, so Color(0.8, 0.9, 0.4) in the GDScript comments becomes new Color(0.8f, 0.9f, 0.4f) in the C# comments.

[YuriSizov]

To remove repetition and make it translatable I think that at least the leading comments can be moved out of code blocks and into the surrounding text.

Though, I'm not sure if there is the same issue with code blocks being untranslatable in the class ref...

[setanarut]

@aaronfranke The word "profile" is used incorrectly (10 times). Word should be a "color model" or just a "color". The "color profile" and "color model" and "color space" mean different things.

wrong

Constructs a color from an RGBA profile using values between 0 and 1.

correct

Constructs a RGBA color using values between 0 and 1.

correct

Constructs a color object from RGBA color model using values between 0 and 1.

[akien-mga]

I think the point of the RGBA() pseudo code was to show that the four parameters encode red, green, blue and optionally alpha in order. Not sure the change to Color8() preserves this meaning, though it makes it valid code and not pseudo code.

[akien-mga]

Well looking at further examples, maybe not. It was just that whoever wrote the docs really preferred 8-bit I guess... So the change is fine

[aaronfranke]

The order of the parameters should already be conveyed via the constructor argument order above the code example, and it also shows up when writing the code in GDScript.

[akien-mga]

Thanks!