Uploader API need Review

Colin Clark colin.clark at utoronto.ca
Fri Apr 24 22:03:18 UTC 2009


Eli,

I'm confused by an apparent inconsistency in the way you've chosen to  
distinguish between "general" and "advanced" options. You've put two  
of the subcomponent configuration options, fileQueueView and  
decorators, in the Advanced section. But then you have other similar  
options, totalProgressBar and focusWithEvent, which you've left in the  
general section. Any particular reason?

In general, a user won't need to worry about any subcomponent-related  
configuration options unless they do one of two things:

1. Change the default template and want to rebind their selectors
2. Create their own alternative implementations of a subcomponent

That said, I'm wondering if perhaps the our API documentation should  
be treated as reference documentation: a comprehensive view of the  
features offered by a component. Our tutorials, on the other hand,  
would be the place where users are guided through standard and  simple  
ways of using a component.

If you do think there's a good motivation for distinguishing between  
general and advanced options, we should have a clear criteria for each  
category, and do this consistently across our documentation.

Thoughts?

Colin

On 23-Apr-09, at 9:07 PM, Eli Cochran wrote:

> I've added some missing options to the Uploader API document and  
> improved the section on running locally.
>
> One of the things that I did was pull two of the options into a  
> separate section called advanced options. But I'm not sure about it.  
> I would love someone to give it a review.
>
> http://wiki.fluidproject.org/display/fluid/Uploader+API
>
> Thanks,
> Eli
>
> . . . . . . . . . . .  .  .   .    .      .         .              .                     .
>
> Eli Cochran
> user interaction developer
> ETS, UC Berkeley
>
>
> _______________________________________________________
> fluid-work mailing list - fluid-work at fluidproject.org
> To unsubscribe, change settings or access archives,
> see http://fluidproject.org/mailman/listinfo/fluid-work

---
Colin Clark
Technical Lead, Fluid Project
Adaptive Technology Resource Centre, University of Toronto
http://fluidproject.org




More information about the fluid-work mailing list