fluid.initRendererComponent options: any 'unsupported'?

[Cheetham, Anastasia]

Antranig, thanks for the clarification. So to make sure I understand correctly:


On 2010-12-08, at 4:31 PM, Antranig Basman wrote:

> I think everything under "rendererFnOptions" should be considered 
> unsupported.

So basically: Don't even mention "rendererFnOptions" in the user-facing options.

> Yes, "model" is not necessary on rendererOptions since everything is 
> governed by the top level model,

So anything that is mentioned the top level (such as 'model') should not be mentioned for lower levels in the user-facing docs (the internals will take care of ensuring that the options are passed on). Options that are exclusive to the lower level should be documented.

> and similarly for elements of 
> "expanderOptions", this doesn't need to be configured more than once.

"expanderOptions" is a partof "rendererFnOptions" and so wouldn't even be mentioned, right??

> I guess I have *some* concerns about the stability of all of this API 
> since it has not really been through much review and consideration. For 
> example the "selectors", "repeatingSelectors" and "selectorsToIgnore" 
> pattern worries me a bit as well - I presume we are designating this 
> entire function as part of "sneak peek" in any case, since it is all new 
> in this release.

Yes, the entire fluid.initRendererComponent() function is branded as Sneak Peek, so users should be suitably warned.


-- 
Anastasia Cheetham     Inclusive Design Research Centre
acheetham at ocad.ca            Inclusive Design Institute
                                        OCAD University