<div class="gmail_extra">I think Dave and Tom's comments are illustrative of the wider point I am trying to make. Every individual is unique. They bring their own unique experience to bear on anything new and interpret it accordingly. Dave's reference to "persistent" makes perfect sense to me in the context of how he explains it in relation to having read my description of the "Display Text". However it makes little sense to me in terms of what the "Display Text" is in XOT. The meaning that Dave took from my description was not the meaning that I was seeking to convey. My communication was at fault. </div>
<div class="gmail_extra"><br></div><div class="gmail_extra">Whatever approach you take will meet some peoples needs and not others. What makes sense for one person does not make sense for another. The XOT community is not a single entity with a common understanding. It is composed of thousands of individuals, some of whom will be relatively new to XOT and others who will have varying degrees of experience. There will be people who are apprehensive about anything new whilst others will be excited by change. The very pages that might be thought to be at risk of frightening some people off will be the same pages that others are eager to get to grips with.</div>
<div class="gmail_extra"><br></div><div class="gmail_extra">The display text / language text or whatever you chose to call it is a side issue. If you don't like the current approach then the most sensible fall back is to place all the text in the main form flagged as language text. But the current situation is entirely consistent with a number of pages that already exist in XOT that do not display correctly until you add some additional data. Try creating a quiz, in the current (not beta) version of XOT and then preview your page. You will see "undefined" against the places where the options are. It's not a problem, just a feature of the page. Like the display text block it is resolved by adding the appropriate child elements. No one has a problem with that.</div>
<div class="gmail_extra"><br></div><div class="gmail_extra">My main point is that in a situation in which different people will have different expectations it is inevitable that some people will find themselves confused with how a page operates, either because the page is new, or the user is new to XOT. Most applications provide some kind of help to assist the user to overcome any issues they have with the software.</div>
<div class="gmail_extra"><br></div><div class="gmail_extra">I believe that a key part of making XOT intuitive is to provide a facility to deliver a simple help file that the author can access for the page they are trying to use. This could go a long way to answering questions like, What does the page do? What does this field do? Any common gotchas with the page. Once in place it would become part of the user's "model" of how XOT operates. When a new page came out the user would expect a help file to be available for them to refer to if they had any difficulty understanding the page.</div>
<div class="gmail_extra"><br></div><div class="gmail_extra">The connector pages are not particularly advanced, they are just a new concept being made available in a software environment that has no way of explaining to the user what that concept is or how it could be applied. When Julian asked in an earlier post "what does the Inventory page do?" It was a valid question but the only place you can put a very limited answer is in the Page description in the xwd. There is no where currently in XOT where the user can discover how to make use of that page. This may help to increase the demand for training courses in how to use XOT. But one could argue that if a product needs a training course before you can use it then it is neither intuitive or FWS.</div>
<div class="gmail_extra"><br></div><div class="gmail_extra">Kind regards</div><div class="gmail_extra"><br></div><div class="gmail_extra">Johnathan</div><div class="gmail_extra"><br><div class="gmail_quote">On 26 April 2012 11:42, Ron Mitchell <span dir="ltr"><<a href="mailto:ronm@mitchellmedia.co.uk" target="_blank">ronm@mitchellmedia.co.uk</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div lang="EN-GB" link="blue" vlink="purple"><div><div class="im"><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">></span> I think that we are all working towards the same end - that of enhancing XOT and Xerte whilst keeping the users on board and happy.<</p>
<p class="MsoNormal"> </p></div><p class="MsoNormal"><span style="color:#7030a0">I think we all agree here and all your work on this Jonathan is clear for all to see and very impressive! </span></p><p class="MsoNormal"><span style="color:#7030a0">However Xerte users aren't the issue here it's the typical XOT users and more specifically the majority of XOT users who are teachers/lecturers and in a growing number of cases learners. A lot of time and effort has gone into promoting XOT and encouraging these users and I think Tom and Inge have been doing the same with their communities. I'm sure we all know this and there are some that are vaguely aware of what's coming in the new release and exited by the opportunities afforded by these developments. But the majority are still getting to grips with what was there before and we want to keep both categories of users happy especially the majority. I think we can do this with a few changes.</span></p>
<div class="im"><p class="MsoNormal"> </p><p class="MsoNormal">>So what do we do about display text?</p></div><p class="MsoNormal">We could<br>1. Remove the "display text" child elements and put the display text fields in the top level form flagged as "language" - people still won't know what to do with it, but they will probably miss seeing it anyway.<br>
2. Keep the "display text" child but add a hidden copy of the same data in the page's new nodes entry, so that the page works without adding the "display text" child.<br>3. Leave things as they are and let people know in the new release that they now have access to the text that used to be built into the model files, if they want to change it, but otherwise they can leave it as it is. It is a feature of the new release.<</p>
<p class="MsoNormal"> </p><p class="MsoNormal"><span style="color:#7030a0">I personally think 1 or 2 are the best options here and the main think is to ensure the pages work without these options needing to be added or changed. e.g. at the moment with the hotpot image connector items like the close button aren't positioned correctly without the display text page being added.</span></p>
<p class="MsoNormal"><span style="color:#7030a0"> </span></p><p class="MsoNormal"><span style="color:#7030a0">I'm still testing and will report back later but the other question I think is whether we keep the new "connectors" menu or have an "advanced" menu or even "Community" menu where all non-Nottingham pages appear? </span></p>
<p class="MsoNormal"><span style="color:#7030a0"> </span></p><p class="MsoNormal"><span style="color:#7030a0">Having an advanced menu and moving the more complex page types there (including perhaps the Interactive Diagram page) at least makes it obvious and clear that anyone attempting to use those pages realise that they are categorised as advanced. I agree with Julian that there is a balance to be had where previously there was arguably only one or two pages that we might categorise as advanced whereas now we have quite a few I think.</span></p>
<p class="MsoNormal"> </p><p class="MsoNormal"><a name="136ee3ec3bba2488__MailEndCompose"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">HTH</span></a></p><p class="MsoNormal">
<span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">Ron</span></p><div style="border:none;border-top:solid #b5c4df 1.0pt;padding:3.0pt 0cm 0cm 0cm"><p class="MsoNormal"><b><span lang="EN-US" style="font-size:10.0pt;font-family:"Tahoma","sans-serif"">From:</span></b><span lang="EN-US" style="font-size:10.0pt;font-family:"Tahoma","sans-serif""> <a href="mailto:xerte-dev-bounces@lists.nottingham.ac.uk" target="_blank">xerte-dev-bounces@lists.nottingham.ac.uk</a> [mailto:<a href="mailto:xerte-dev-bounces@lists.nottingham.ac.uk" target="_blank">xerte-dev-bounces@lists.nottingham.ac.uk</a>] <b>On Behalf Of </b>Kemp Johnathan<br>
<b>Sent:</b> 26 April 2012 11:00</span></p><div><div class="h5"><br><b>To:</b> For Xerte technical developers<br><b>Subject:</b> [Xerte-dev] Re: Goal</div></div></div><div><div class="h5"><p class="MsoNormal"> </p><div><p class="MsoNormal">
<span style="color:#3366ff">The 'displaytext' child really confused me: I had no idea what to do with it, and I know that for some people, that will be very off putting, so it's remembering the FWS mantra</span></p>
</div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">I think that we are all working towards the same end - that of enhancing XOT and Xerte whilst keeping the users on board and happy.</p></div><div><p class="MsoNormal">
 </p></div><div><p class="MsoNormal">Recent events, like Fay's comment regarding some documentation for the Interactive Diagram (customHotspot) page, Julian's experience with the "display text" child, and my own experiences in coming to grips with the Interactive Diagram page (if my memory is correct I think Julian told me how to use it in a response to my posting to the mail shortly after it first came out ) and the Mapstraction and JMOL pages which I have never got to work, have lead me to re-think the problem. I can't help feeling that "keep it simple" is not the problem, but rather an attempt at a solution to an unstated problem. I think the underlying problem is about "keeping it intuitive". </p>
</div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">In general something that is simple ought also to result in it being intuitive. But the Interactive Diagram page is demonstrably counter intuitive, though very simple to use. This is not meant as a criticism. The specific context of XOT, where there are multiple examples of pages that work by adding elements to the page's structure in the project tree e.g. adding a question to a quiz; adding an option to a question; adding a hotspot in the Hotspot Image page; creates for the user a model of how things work. Intuition then expects other pages to work in a similar way. It comes as a surprise then when a page that clearly is about adding hotspots offers no feature in the wizard to add a hotspot (it's all done by editing the drawing). This does not make the page a bad, poor or inappropriate page. It's a damn good page. It is also easy to use, but only after you understand how it works.</p>
</div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">The "display text" child is simplicity itself. It is entirely consistent with other Xerte pages in that it is presented in the wizard as a child item and added just like any other child item. The problem appears to be that for Julian it just did not make any sense - "I had no idea what to do with it". Many other pages have a new language check box in the wizard. No one has had a problem yet with them, probably because they haven't noticed it or have ignored it. But it is just another way of dealing with the same issue. </p>
</div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">"Display text" is the term I have used, as it made the most sense to me, for all the text contained in a page that does not need to change across multiple instances of that page type. It is the label on a button, the phrase "question 1 of 8" etc. All this text used to reside in the code of the model file. But to enable XOT to be translated into different languages it had to come out of the model file. It could have been hidden inside the xwd file with no option to edit it, but at the time of the discussions around how internationalisation would be handled Inge raised the idea that the ability to edit it could be useful. You could change it to suit your audience or to introduce a bit of variety. One quiz page might say "Well done you have completed the quiz", whilst the next might say "Good job!" for example.</p>
</div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">So the current situation is that many of the original XOT pages have some "display text". For most pages it is hidden in the top level form under the language check box. What concerned me about this approach was if there was a lot of display text. Since the display text will not be changed by most authors I wanted to keep it separate, rather than to make the top level form excessively long. For me it was a logical separation of different types of data.</p>
</div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">With the existing pages the display text presented a problem of backward compatibility with pre-existing XOT projects. The ultimate example of this is the Quiz page. To ensure that the new model would work with existing page data I had to keep a default set of display text values in the model as existing pages would not be able to automatically collect the new display text data from the xwd file. To ensure that authors in languages other than English did not see English values in their page I had to add the display text values to the "new nodes" definition for the page. To make the display text editable in the xwd form without cluttering up the page's main form, I added a "display text" child.  </p>
</div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">Since all the new pages - the Connector pages and the Inventory page will have no issues of legacy pages in existing projects I kept things simple and just added the child element "Display text".</p>
</div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">So what do we do about display text?</p></div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">We could</p></div><div><p class="MsoNormal">
 </p></div><ol start="1" type="1"><li class="MsoNormal">Remove the "display text" child elements and put the display text fields in the top level form flagged as "language" - people still won't know what to do with it, but they will probably miss seeing it anyway.</li>
<li class="MsoNormal">Keep the "display text" child but add a hidden copy of the same data in the page's new nodes entry, so that the page works without adding the "display text" child.</li><li class="MsoNormal">
Leave things as they are and let people know in the new release that they now have access to the text that used to be built into the model files, if they want to change it, but otherwise they can leave it as it is. It is a feature of the new release.</li>
</ol><div><p class="MsoNormal">You know my preference as it is already implemented. For me the issue of "display text" is an example of a wider issue. There will be times when the purpose or usage of a feature of a page, or even the whole page, will not intuitive to some users. There is a way of adding a pdf file to a project, resulting in a help button displaying on the main navigation. If you had a new folder e.g. pageDocs, that operated like the "thumbs" folder, you could add a pdf file for a page that explained the purpose of the page, the various elements and the fields in those elements to the user. One entry in the xwd file could identify the form, in the same way that the thumbs file is identified. </p>
</div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">Different people have different understandings of how things are, leading to different intuitions as to how something should operate. By being able to provide an explanation of how a page works we can keep people on board even when the XOT reality is an imperfect match for their expectations. It also opens up the opportunity to make more complex pages FWS.</p>
</div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">Kind regards</p></div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">Johnathan</p></div><div><p class="MsoNormal"> </p></div><div><p class="MsoNormal">
 </p></div><div><p class="MsoNormal"> </p><div><p class="MsoNormal">On 25 April 2012 17:38, Julian Tenney <<a href="mailto:Julian.Tenney@nottingham.ac.uk" target="_blank">Julian.Tenney@nottingham.ac.uk</a>> wrote:</p>
<p class="MsoNormal">OK, I think I'm being persuaded.<br><br>We need to arrive at a consensus around the new stuff. Maybe 'advanced' is a better section name for the connectors than 'connectors', or maybe it's just a case of think about automating some of the stuff that is correctly configured by the form. The 'displaytext' child really confused me: I had no idea what to do with it, and I know that for some people, that will be very off putting, so it's remembering the FWS mantra, and trying to apply the predictable consistent usability stuff to make it as simple and straightforward as possible. Documentation and examples will be useful as well.</p>
<div><div><p class="MsoNormal"><br><br>-----Original Message-----<br>From: <a href="mailto:xerte-dev-bounces@lists.nottingham.ac.uk" target="_blank">xerte-dev-bounces@lists.nottingham.ac.uk</a> [mailto:<a href="mailto:xerte-dev-bounces@lists.nottingham.ac.uk" target="_blank">xerte-dev-bounces@lists.nottingham.ac.uk</a>] On Behalf Of Tom Reijnders<br>
Sent: 25 April 2012 10:53<br>To: For Xerte technical developers<br>Subject: [Xerte-dev] Re: Goal<br><br>Yes, I think we did. The only thing missing at the moment, and I am<br>working on that is a button in the management.php of XOT to<br>
add/replace a page in one of the templates.<br><br>But, that was NOT the only reason to do this in my opinion. Now all<br>the model files are the same whether they are used in XOT or the Xerte<br>pagetemplates or as pageWizard, and we can translate them and maintain<br>
them....<br><br>Having done all this, we now have the OPTION (not obligation) to add<br>the models Johnathan created to XOT (We don't have to, and a user can<br>do that him/herself through the management page.)<br><br>
Also we still can create an visual clue that some of the pages require<br>a better understanding of the whol rpoject than just fill in the blanks.<br><br>The users we spoke top so far are  VERY enthousistic by all the<br>
possibillities they now get from XOT and had to do in Xerte firts.<br><br>Also, and that was part of the goal as well, it is now easier for a<br>person not in the core team to create models and be able to<br>maintain/translate them without redoing all the tedious editing/adding<br>
them to the general xwd's etc....<br><br>Tom<br><br><br><br>Citeren Julian Tenney <<a href="mailto:Julian.Tenney@nottingham.ac.uk" target="_blank">Julian.Tenney@nottingham.ac.uk</a>>:<br><br>> Have we achieved the goal we set out to of making it easier to build<br>
> / manage a collection of models  for an administrator wanting to<br>> adding his own models? This was one of Ron's requests: has it been<br>> achieved?<br>><br>> In other words, with the tools that Tom and Jonathan have built, is<br>
> it easier for you to create the xwd of your choice, or was it easier<br>> when you just had to copy sections of an xwd in a text editor?<br>><br>> A serious question.<br>> This message and any attachment are intended solely for the<br>
> addressee and may contain confidential information. If you have<br>> received this message in error, please send it back to me, and<br>> immediately delete it.   Please do not use, copy or disclose the<br>> information contained in this message or in any attachment.  Any<br>
> views or opinions expressed by the author of this email do not<br>> necessarily reflect the views of the University of Nottingham.<br>><br>> This message has been checked for viruses but the contents of an attachment<br>
> may still contain software viruses which could damage your computer system:<br>> you are advised to perform your own checks. Email communications with the<br>> University of Nottingham may be monitored as permitted by UK legislation.<br>
><br><br><br><br>----------------------------------------------------------------<br>This message was sent using IMP, the Internet Messaging Program.<br><br><br>_______________________________________________<br>Xerte-dev mailing list<br>
<a href="mailto:Xerte-dev@lists.nottingham.ac.uk" target="_blank">Xerte-dev@lists.nottingham.ac.uk</a><br><a href="http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev" target="_blank">http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev</a><br>
<br>_______________________________________________<br>Xerte-dev mailing list<br><a href="mailto:Xerte-dev@lists.nottingham.ac.uk" target="_blank">Xerte-dev@lists.nottingham.ac.uk</a><br><a href="http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev" target="_blank">http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev</a></p>
</div></div></div><p class="MsoNormal"> </p></div><p class="MsoNormal"> </p><p>This message and any attachment are intended solely for the addressee and may contain confidential information. If you have received this message in error, please send it back to me, and immediately delete it. Please do not use, copy or disclose the information contained in this message or in any attachment. Any views or opinions expressed by the author of this email do not necessarily reflect the views of the University of Nottingham. </p>
<p>This message has been checked for viruses but the contents of an attachment may still contain software viruses which could damage your computer system: you are advised to perform your own checks. Email communications with the University of Nottingham may be monitored as permitted by UK legislation. </p>
</div></div></div></div><br>_______________________________________________<br>
Xerte-dev mailing list<br>
<a href="mailto:Xerte-dev@lists.nottingham.ac.uk">Xerte-dev@lists.nottingham.ac.uk</a><br>
<a href="http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev" target="_blank">http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev</a><br>
<br>
This message and any attachment are intended solely for the addressee and may contain confidential information. If you have received this message in error, please send it back to me, and immediately delete it.   Please do not use, copy or disclose the information contained in this message or in any attachment.  Any views or opinions expressed by the author of this email do not necessarily reflect the views of the University of Nottingham.<br>

<br>
This message has been checked for viruses but the contents of an attachment<br>
may still contain software viruses which could damage your computer system:<br>
you are advised to perform your own checks. Email communications with the<br>
University of Nottingham may be monitored as permitted by UK legislation.<br>
<br>
<br></blockquote></div><br></div>