Given that we are expecting to overhaul the API for UIO in 1.5, I feel that we should be selective in what we document in 1.4. It seems to me that the top level UIO API is about as deep as we want to go.
I think it would help if I had a little more information about the current situation. Do you know what implementers are configuring now? Any thoughts on what they will likely want to configure right away? Which of the examples you gave cannot be configured in the top level API? Thanks, Michelle On 2011-08-31, at 11:08 AM, Cheetham, Anastasia wrote: > > UI Options and UI Enhancer have various options and subcomponents that are > technically amenable to configuration. However, we've decided that for 1.4, > we are *not* expecting or recommending that integrators actually do any > configuration: We want them to just use it out of the box and leave it at > that (correct me if I'm wrong, of course). > > My first question is this: > > Should we be documenting all the options/subcomponents that could technically > be configured, or should we deliberately avoid any mention of anything we > *don't* want people to play with? > > My second question would be: > > If the latter course is decided upon, which options/subcomponents will we > consider "public" (and therefore documented) for 1.4? > > Here is a starting list of potential customizations that integrators might > want to carry out. Which of would we support for 1.4, which not? Are there > others we will support, and therefore need to document? > > - custom text on the show/hide button of fat-panel UIO > - custom path to a preview file for full-with-preview > - custom contents of drop-downs > - addition of font families > - addition of themes > - custom default site settings > - custom path to table-of-contents template file > - custom ranges on the sliders > - larger max font size > - larger max line spacing > - custom settings store (i.e. something other than a cookie) > > > -- > Anastasia Cheetham Inclusive Design Research Centre > [email protected] Inclusive Design Institute > OCAD University > > _______________________________________________________ > fluid-work mailing list - [email protected] > To unsubscribe, change settings or access archives, > see http://lists.idrc.ocad.ca/mailman/listinfo/fluid-work ------------------------------------------------------ Michelle D'Souza Inclusive Software Developer Researcher Inclusive Design Research Centre _______________________________________________________ fluid-work mailing list - [email protected] To unsubscribe, change settings or access archives, see http://lists.idrc.ocad.ca/mailman/listinfo/fluid-work
