[Dojo-interest] dojox.color.Palette documentation and API

[AxxL]

Hi all.

the dojox.color.Palette documentation and API needs some updates.

links:
- API: http://dojotoolkit.org/api/dojox/color/Palette.html
- Palette documentation:
http://www.dojotoolkit.org/reference-guide/dojox/color/Palette.html

- the API doesn't reflect the documenation, especially the pre-defined
"color theory models" and the whole usage possibilities.
- the API doesn't describe the dojox.color.Palette.generate method.
- some "color theory models" in the documentation are incorrect:
--> documented "complimentary", must be "complementary"
--> documented "splitComplimentary", must be "splitComplementary"
--> "shades" is missing.

You have to dig deep in the code to find this. The whole dojox.color thing
is badly documentated, especially for updating from 1.2 to 1.3, when the
namespace has completely changed. Updating from 1.2 to 1.3 was a lot of
work.

None of the "color theory models" reflects a real color ramp with colors
going from light to dark. The former "dojox.color.Generator.monochromatic"
of v1.2 produced a different color ramp with a more homogeneous result.
Perhaps someone has an idea for generating a good color ramp with 5 steps
from light color to dark color.

Best regards,
AxxL
-- 
View this message in context: http://dojo-toolkit.33424.n3.nabble.com/dojox-color-Palette-documentation-and-API-tp882672p882672.html
Sent from the Dojo Toolkit mailing list archive at Nabble.com.