<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">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. <div class=""><br class=""></div><div class=""><div>Michelle</div><div><br class=""></div><div><br class=""><blockquote type="cite" class=""><div class="">On Mar 7, 2019, at 10:50 AM, Hung, Jonathan <<a href="mailto:jhung@ocadu.ca" class="">jhung@ocadu.ca</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div id="divtagdefaultwrapper" dir="ltr" style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; font-size: 11pt;" class=""><div style="margin-top: 0px; margin-bottom: 0px;" class="">Thanks Alan. <span style="font-size: 11pt;" class="">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.</span></div><div style="margin-top: 0px; margin-bottom: 0px;" class=""><br class=""></div><div style="margin-top: 0px; margin-bottom: 0px;" class="">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? </div><div style="margin-top: 0px; margin-bottom: 0px;" class=""><br class=""></div><div style="margin-top: 0px; margin-bottom: 0px;" class="">- Jon.</div><div style="margin-top: 0px; margin-bottom: 0px;" class=""><br class=""></div><div id="Signature" class=""><div id="divtagdefaultwrapper" dir="ltr" style="font-size: 12pt; font-family: Calibri, Arial, Helvetica, sans-serif, EmojiFont, "Apple Color Emoji", "Segoe UI Emoji", NotoColorEmoji, "Segoe UI Symbol", "Android Emoji", EmojiSymbols;" class=""><p style="margin-top: 0px; margin-bottom: 0px;" class=""></p><div class="">---<br class="">Jonathan Hung, Inclusive Designer<br class="">Email:<span class="Apple-converted-space"> </span><a href="mailto:jhung@ocadu.ca" style="color: purple; text-decoration: underline;" class="">jhung@ocadu.ca</a><br class="">OCAD University<br class="">Inclusive Design Research Centre</div><br class=""><p style="margin-top: 0px; margin-bottom: 0px;" class=""></p></div></div></div><hr tabindex="-1" style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; display: inline-block; width: 707.546875px;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class=""></span><div id="divRplyFwdMsg" dir="ltr" style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><font face="Calibri, sans-serif" style="font-size: 11pt;" class=""><b class="">From:</b><span class="Apple-converted-space"> </span>Harnum, Alan<br class=""><b class="">Sent:</b><span class="Apple-converted-space"> </span>March 7, 2019 10:17:26 AM<br class=""><b class="">To:</b><span class="Apple-converted-space"> </span>Hung, Jonathan; Fluid Work<br class=""><b class="">Subject:</b><span class="Apple-converted-space"> </span>Re: Documentation gap for Prefs Framework, and UIO confusion</font><div class=""> </div></div><div lang="EN-CA" link="blue" vlink="purple" style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><div class="x_WordSection1"><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><span lang="EN-US" class="">Hi Jon,</span></div><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span lang="EN-US" class=""> </span></p><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><span lang="EN-US" class="">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.</span></div><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span lang="EN-US" class=""> </span></p><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><span lang="EN-US" class="">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:</span></div><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span lang="EN-US" class=""> </span></p><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><span lang="EN-US" class="">--START QUOTE—</span></div><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span lang="EN-US" class=""> </span></p><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><span lang="EN-US" style="" class="">Briefly, I want to highlight a distinction between two pieces of the Fluid Project’s Infusion JS framework:</span><span style="font-size: 12pt;" class=""></span></div><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif; font-variant-caps: normal; text-align: start; word-spacing: 0px;"><span lang="EN-US" style="" class=""> </span><span style="font-size: 12pt;" class=""></span></p><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif; font-variant-caps: normal; text-align: start; word-spacing: 0px;" class=""><b class=""><span lang="EN-US" style="" class="">User Interface Options</span></b><span class="x_apple-converted-space"><span lang="EN-US" style="" class=""> </span></span><span lang="EN-US" style="" class="">(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<span class="x_apple-converted-space"> </span><a href="https://docs.fluidproject.org/infusion/development/tutorial-userInterfaceOptions/UserInterfaceOptions.html" style="color: purple; text-decoration: underline;" class=""><span style="color: rgb(149, 79, 114);" class="">https://docs.fluidproject.org/infusion/development/tutorial-userInterfaceOptions/UserInterfaceOptions.html</span></a><span class="x_apple-converted-space"> </span>and<span class="x_apple-converted-space"> </span><a href="https://docs.fluidproject.org/infusion/development/UserInterfaceOptionsAPI.html" style="color: purple; text-decoration: underline;" class=""><span style="color: rgb(149, 79, 114);" class="">https://docs.fluidproject.org/infusion/development/UserInterfaceOptionsAPI.html</span></a>, what we typically use on our own sites, and what we recommend for use by others if they don’t have specific needs.</span><span style="font-size: 12pt;" class=""></span></div><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif; font-variant-caps: normal; text-align: start; word-spacing: 0px;"><span lang="EN-US" style="" class=""> </span><span style="font-size: 12pt;" class=""></span></p><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif; font-variant-caps: normal; text-align: start; word-spacing: 0px;" class=""><span lang="EN-US" style="" class="">The<span class="x_apple-converted-space"> </span><b class="">Preferences Framework</b><span class="x_apple-converted-space"> </span>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<span class="x_apple-converted-space"> </span><a href="https://docs.fluidproject.org/infusion/development/PreferencesFramework.html" style="color: purple; text-decoration: underline;" class=""><span style="color: rgb(149, 79, 114);" class="">https://docs.fluidproject.org/infusion/development/PreferencesFramework.html</span></a><span class="x_apple-converted-space"> </span>and corresponding sections.</span><span style="font-size: 12pt;" class=""></span></div><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif; font-variant-caps: normal; text-align: start; word-spacing: 0px;"><span lang="EN-US" style="" class=""> </span><span style="font-size: 12pt;" class=""></span></p><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif; font-variant-caps: normal; text-align: start; word-spacing: 0px;" class=""><span lang="EN-US" style="" class="">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.</span><span style="font-size: 12pt;" class=""></span></div><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span lang="EN-US" class=""> </span></p><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><span lang="EN-US" class="">-END QUOTE—</span></div><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span lang="EN-US" class=""> </span></p><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><span lang="EN-US" class="">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.</span></div><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span lang="EN-US" class=""> </span></p><div style="border-style: solid none none; border-top-width: 1pt; border-top-color: rgb(181, 196, 223); padding: 3pt 0cm 0cm;" class=""><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><b class=""><span style="font-size: 12pt;" class="">From:<span class="Apple-converted-space"> </span></span></b><span style="font-size: 12pt;" class="">fluid-work <<a href="mailto:fluid-work-bounces@lists.idrc.ocad.ca" style="color: purple; text-decoration: underline;" class="">fluid-work-bounces@lists.idrc.ocad.ca</a>> on behalf of "Hung, Jonathan" <<a href="mailto:jhung@ocadu.ca" style="color: purple; text-decoration: underline;" class="">jhung@ocadu.ca</a>><br class=""><b class="">Date:<span class="Apple-converted-space"> </span></b>Thursday, March 7, 2019 at 9:55 AM<br class=""><b class="">To:<span class="Apple-converted-space"> </span></b>Fluid Work <<a href="mailto:fluid-work@fluidproject.org" style="color: purple; text-decoration: underline;" class="">fluid-work@fluidproject.org</a>><br class=""><b class="">Subject:<span class="Apple-converted-space"> </span></b>Documentation gap for Prefs Framework, and UIO confusion</span></div></div><div class=""><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"> </p></div><div id="x_divtagdefaultwrapper" class=""><div style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class="">Hi everyone,</span></div><p style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class=""> </span></p><div style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class="">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:</span></div><p style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class=""> </span></p><ol start="1" type="1" style="margin-bottom: 0cm;" class=""><li class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span style="font-family: Helvetica;" class="">UI Options a nice user-friendly guide on how to set up UI Options<span class="Apple-converted-space"> </span><a href="https://docs.fluidproject.org/infusion/development/tutorial-userInterfaceOptions/UserInterfaceOptions.html" style="color: purple; text-decoration: underline;" class="">here</a>. The Prefs Framework does not have a similar guide.</span></li><li class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span style="font-family: Helvetica;" class="">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.</span></li><li class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span style="font-family: Helvetica;" class="">Is there a reason to maintain the distinction between Prefs Framework and UIO?</span></li></ol><p style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class=""> </span></p><div style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class="">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:</span></div><p style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class=""> </span></p><ul type="disc" style="margin-bottom: 0cm;" class=""><li class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span style="font-family: Helvetica;" class="">convert the UIO documentation to be Prefs Framework centric</span></li><li class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span style="font-family: Helvetica;" class="">stop using the term "UIO", and focus on the "Prefs Framework"</span></li><li class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span style="font-family: Helvetica;" class="">explain how Prefs Framework can tailored to your needs by either taking away features you don't need, or adding features you want</span></li></ul><p style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class=""> </span></p><p style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class=""> </span></p><div style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class="">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.</span></div><p style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class=""> </span></p><div style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class="">- Jon.</span></div><p style="margin-top: 0px; margin-bottom: 0px;" class=""><span style="font-family: Helvetica;" class=""> </span></p><div id="x_Signature" class=""><div id="x_divtagdefaultwrapper" class=""><div class=""><div style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class=""><span style="font-size: 12pt;" class="">---<br class="">Jonathan Hung, Inclusive Designer<br class="">Email:<span class="Apple-converted-space"> </span><a href="mailto:jhung@ocadu.ca" style="color: purple; text-decoration: underline;" class="">jhung@ocadu.ca</a><br class="">OCAD University<br class="">Inclusive Design Research Centre</span></div></div><p class="x_MsoNormal" style="margin: 0cm 0cm 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;"><span style="font-size: 12pt;" class=""> </span></p></div></div></div></div></div><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">_______________________________________________________</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">fluid-work mailing list -<span class="Apple-converted-space"> </span></span><a href="mailto:fluid-work@lists.idrc.ocad.ca" style="color: purple; text-decoration: underline; font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px;" class="">fluid-work@lists.idrc.ocad.ca</a><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">To unsubscribe, change settings or access archives,</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;" class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;" class="">see<span class="Apple-converted-space"> </span></span><a href="https://lists.idrc.ocad.ca/mailman/listinfo/fluid-work" style="color: purple; text-decoration: underline; font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px;" class="">https://lists.idrc.ocad.ca/mailman/listinfo/fluid-work</a></div></blockquote></div><br class=""></div></body></html>