Documentation gap for Prefs Framework, and UIO confusion

Justin Obara obara.justin at gmail.com
Tue Jul 9 18:18:02 UTC 2019


Hi all,

Sorry to be late to the discussion as I’m just getting back from my leave. Was there ever a conversation about adding more preferences to UIO?

Thanks
Justin

> On Mar 18, 2019, at 11:26 AM, Hung, Jonathan <jhung at ocadu.ca> wrote:
> 
> It would be great if these new features are reviewed and considered to be added to UIO.  Could I ask how soon this might be done? It may be a key feature to some upcoming integrations.
> 
> - Jon.
> 
> ---
> Jonathan Hung, Inclusive Designer
> Email: jhung at ocadu.ca <mailto:jhung at ocadu.ca>
> OCAD University
> Inclusive Design Research Centre
> 
> From: Michelle D'Souza <michelled33 at gmail.com>
> Sent: March 7, 2019 11:34:28 AM
> To: Hung, Jonathan
> Cc: Fluid Work
> Subject: Re: Documentation gap for Prefs Framework, and UIO confusion
>  
> It’s my understanding that as new features became ready for general use we would add them to UIO. I wonder if it’s time to take a look at the new features that have been added to the preferences framework and add the ones that we think should be integrated by default to UIO. This might address the questions you are getting most often. 
> 
> Michelle
> 
> 
>> On Mar 7, 2019, at 10:50 AM, Hung, Jonathan <jhung at ocadu.ca <mailto:jhung at ocadu.ca>> wrote:
>> 
>> Thanks Alan. What you described makes sense. Something like that should make its way into the UIO documentation. I'll make a Jira for it and copy your text as an example.
>> 
>> In the meantime, what would the strategy be for situations where someone wants the features they see in the Prefs Framework (i.e. self-voicing and syllabification, etc.) and wants that "out of the box" experience of integration? 
>> 
>> - Jon.
>> 
>> ---
>> Jonathan Hung, Inclusive Designer
>> Email: jhung at ocadu.ca <mailto:jhung at ocadu.ca>
>> OCAD University
>> Inclusive Design Research Centre
>> 
>> From: Harnum, Alan
>> Sent: March 7, 2019 10:17:26 AM
>> To: Hung, Jonathan; Fluid Work
>> Subject: Re: Documentation gap for Prefs Framework, and UIO confusion
>>  
>> Hi Jon,
>>  
>> Thank you for starting this conversation, as I agree the distinction is not clear; however, I don’t think they are essentially the same in a number of senses. I recognize that some of this distinction might be at the level of “only meaningful to developers”, but that is a meaningful distinction for certain audiences. It’s definitely a meaningful distinction at the level of codebase architecture.
>>  
>> I’m going to quote some of an email I sent to some of the CAST partners in July, as I explained my take on the situation there:
>>  
>> --START QUOTE—
>>  
>> Briefly, I want to highlight a distinction between two pieces of the Fluid Project’s Infusion JS framework:
>>  
>> User Interface Options (UIO) is a “standard” component for providing a UI for end users to customize the appearance and behavior of websites. This is what’s described in the documentation at https://docs.fluidproject.org/infusion/development/tutorial-userInterfaceOptions/UserInterfaceOptions.html <https://docs.fluidproject.org/infusion/development/tutorial-userInterfaceOptions/UserInterfaceOptions.html> and https://docs.fluidproject.org/infusion/development/UserInterfaceOptionsAPI.html <https://docs.fluidproject.org/infusion/development/UserInterfaceOptionsAPI.html>, what we typically use on our own sites, and what we recommend for use by others if they don’t have specific needs.
>>  
>> The Preferences Framework is an underlying piece of the Infusion framework that UIO is built with – the framework is designed to support a wide variety of approaches to building preferences editors, of which UIO is one possible manifestation. It’s described in detail at https://docs.fluidproject.org/infusion/development/PreferencesFramework.html <https://docs.fluidproject.org/infusion/development/PreferencesFramework.html> and corresponding sections.
>>  
>> So particularly when working with integration with other code (especially code also wanting to expose controls to the user to customize a website), there are options beyond “out of the box” use of UIO that can still draw on the Fluid’s Projects codebase. These have a higher complexity than UIO, but I wanted to make sure to highlight the distinction above.
>>  
>> -END QUOTE—
>>  
>> The PF/UIO relationship is something like the one between D3.js (a generalized data-driven document framework, which has powerful usage for building data visualizations but also many other applications) and C3.js, Plotly, NVD3, etc (various chart generation libraries built on top of D3.js) – it is quite meaningful if you’re a developer making choices about how to build something.
>>  
>> From: fluid-work <fluid-work-bounces at lists.idrc.ocad.ca <mailto:fluid-work-bounces at lists.idrc.ocad.ca>> on behalf of "Hung, Jonathan" <jhung at ocadu.ca <mailto:jhung at ocadu.ca>>
>> Date: Thursday, March 7, 2019 at 9:55 AM
>> To: Fluid Work <fluid-work at fluidproject.org <mailto:fluid-work at fluidproject.org>>
>> Subject: Documentation gap for Prefs Framework, and UIO confusion
>>  
>> Hi everyone,
>>  
>> I spend a fair amount of time working with partners about integrating our tools into their projects, namely UI Options. Ideally I would like to be able to point our partners to a single demo, and a single guide so they can get up and running as quickly as possible. I can do that with UIO, but not Prefs Framework currently:
>>  
>> UI Options a nice user-friendly guide on how to set up UI Options here <https://docs.fluidproject.org/infusion/development/tutorial-userInterfaceOptions/UserInterfaceOptions.html>. The Prefs Framework does not have a similar guide.
>> It's never really explained in the documentation what the differences are between the Prefs Framework and UIO, and why someone would choose one over the other.
>> Is there a reason to maintain the distinction between Prefs Framework and UIO?
>>  
>> To me the core issue is that Prefs Framework and UIO are essentially the same, but currently there is a disparity in the documentation between these two entities. Would it make sense to:
>>  
>> convert the UIO documentation to be Prefs Framework centric
>> stop using the term "UIO", and focus on the "Prefs Framework"
>> explain how Prefs Framework can tailored to your needs by either taking away features you don't need, or adding features you want
>>  
>>  
>> For now I will continue to point partners to UIO because it's a friendlier path, but ideally I would like a strategy for getting them to use Prefs Framework instead.
>>  
>> - Jon.
>>  
>> ---
>> Jonathan Hung, Inclusive Designer
>> Email: jhung at ocadu.ca <mailto:jhung at ocadu.ca>
>> OCAD University
>> Inclusive Design Research Centre
>>  
>> _______________________________________________________
>> fluid-work mailing list - fluid-work at lists.idrc.ocad.ca <mailto:fluid-work at lists.idrc.ocad.ca>
>> To unsubscribe, change settings or access archives,
>> see https://lists.idrc.ocad.ca/mailman/listinfo/fluid-work <https://lists.idrc.ocad.ca/mailman/listinfo/fluid-work>
> _______________________________________________________
> fluid-work mailing list - fluid-work at lists.idrc.ocad.ca
> To unsubscribe, change settings or access archives,
> see https://lists.idrc.ocad.ca/mailman/listinfo/fluid-work

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.idrc.ocad.ca/pipermail/fluid-work/attachments/20190709/74ab98ba/attachment.html>


More information about the fluid-work mailing list