<html>
  <head>
    <meta content="text/html; charset=ISO-8859-1"
      http-equiv="Content-Type">
  </head>
  <body bgcolor="#FFFFFF" text="#000000">
    Persisted? I am either totally confused now, or my grasp of the
    English language is failing me (I am still confused). <br>
    <br>
    If I understand things correctly with the Display Text node you can
    change the button labels used for example in the quiz. These used to
    be hard coded in the model, and now can be changed by the user. <br>
    <br>
    That, in my mind, bears no connection to 'Persist' where I would
    expect the END user, the learner to change something and that is
    remembered/persisted for the next time the LO is visited.<br>
    <br>
    Tom<br>
    <br>
    <br>
    Op 26-4-2012 12:16, Dave Burnett schreef:
    <blockquote cite="mid:BLU153-W6342E9486F348ECAB9B7DBA7240@phx.gbl"
      type="cite">
      <style><!--
.hmmessage P
{
margin:0px;
padding:0px
}
body.hmmessage
{
font-size: 10pt;
font-family:Tahoma
}
--></style>
      <div dir="ltr">
        <div><br>
        </div>
        <div>To me it would lack intuitiveness because "display" has so
          many context sensitive meanings.</div>
        <div><br>
        </div>
        <div>"Persisted" text would spell it out for me.</div>
        <div>:-)</div>
        <div><br>
        </div>
        <br>
        <div>
          <hr id="stopSpelling">Date: Thu, 26 Apr 2012 10:59:42 +0100<br>
          From: <a class="moz-txt-link-abbreviated" href="mailto:johnathan.kemp@ntlworld.com">johnathan.kemp@ntlworld.com</a><br>
          To: <a class="moz-txt-link-abbreviated" href="mailto:xerte-dev@lists.nottingham.ac.uk">xerte-dev@lists.nottingham.ac.uk</a><br>
          Subject: [Xerte-dev] Re: Goal<br>
          <br>
          <div class="ecxgmail_extra">
            <font 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</font></div>
          <div class="ecxgmail_extra"><br>
          </div>
          <div class="ecxgmail_extra">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.</div>
          <div class="ecxgmail_extra">
            <br>
          </div>
          <div class="ecxgmail_extra">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". </div>
          <div class="ecxgmail_extra"><br>
          </div>
          <div class="ecxgmail_extra">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.</div>
          <div class="ecxgmail_extra"><br>
          </div>
          <div class="ecxgmail_extra">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. </div>
          <div class="ecxgmail_extra"><br>
          </div>
          <div class="ecxgmail_extra">"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.</div>
          <div class="ecxgmail_extra"><br>
          </div>
          <div class="ecxgmail_extra">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.</div>
          <div class="ecxgmail_extra"><br>
          </div>
          <div class="ecxgmail_extra">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.  </div>
          <div class="ecxgmail_extra"><br>
          </div>
          <div class="ecxgmail_extra">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".</div>
          <div class="ecxgmail_extra"><br>
          </div>
          <div class="ecxgmail_extra">So what do we do about display
            text?</div>
          <div class="ecxgmail_extra"><br>
          </div>
          <div class="ecxgmail_extra">We could</div>
          <div class="ecxgmail_extra"><br>
          </div>
          <ol>
            <li class="ecxgmail_extra">
              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>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>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>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. </div>
          <div><br>
          </div>
          <div>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.</div>
          <div><br>
          </div>
          <div>Kind regards</div>
          <div><br>
          </div>
          <div>Johnathan</div>
          <div><br>
          </div>
          <div><br>
          </div>
          <div class="ecxgmail_extra"><br>
            <div class="ecxgmail_quote">On 25 April 2012 17:38, Julian
              Tenney <span dir="ltr"><<a moz-do-not-send="true"
                  href="mailto:Julian.Tenney@nottingham.ac.uk">Julian.Tenney@nottingham.ac.uk</a>></span>
              wrote:<br>
              <blockquote class="ecxgmail_quote" style="border-left:1px
                #ccc solid;padding-left:1ex">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.<br>
                <div class="ecxHOEnZb">
                  <div class="h5"><br>
                    <br>
                    -----Original Message-----<br>
                    From: <a moz-do-not-send="true"
                      href="mailto:xerte-dev-bounces@lists.nottingham.ac.uk">xerte-dev-bounces@lists.nottingham.ac.uk</a>
                    [mailto:<a moz-do-not-send="true"
                      href="mailto:xerte-dev-bounces@lists.nottingham.ac.uk">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 moz-do-not-send="true"
                      href="mailto:Julian.Tenney@nottingham.ac.uk">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 moz-do-not-send="true"
                      href="mailto:Xerte-dev@lists.nottingham.ac.uk">Xerte-dev@lists.nottingham.ac.uk</a><br>
                    <a moz-do-not-send="true"
                      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 moz-do-not-send="true"
                      href="mailto:Xerte-dev@lists.nottingham.ac.uk">Xerte-dev@lists.nottingham.ac.uk</a><br>
                    <a moz-do-not-send="true"
                      href="http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev"
                      target="_blank">http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev</a><br>
                  </div>
                </div>
              </blockquote>
            </div>
            <br>
          </div>
          <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>
          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.
          <br>
          <br>
          _______________________________________________
          Xerte-dev mailing list
          <a class="moz-txt-link-abbreviated" href="mailto:Xerte-dev@lists.nottingham.ac.uk">Xerte-dev@lists.nottingham.ac.uk</a>
          <a class="moz-txt-link-freetext" href="http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev">http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev</a>
          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.
          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.</div>
      </div>
      <br>
      <fieldset class="mimeAttachmentHeader"></fieldset>
      <br>
      <pre wrap="">_______________________________________________
Xerte-dev mailing list
<a class="moz-txt-link-abbreviated" href="mailto:Xerte-dev@lists.nottingham.ac.uk">Xerte-dev@lists.nottingham.ac.uk</a>
<a class="moz-txt-link-freetext" href="http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev">http://lists.nottingham.ac.uk/mailman/listinfo/xerte-dev</a>

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.

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.

</pre>
    </blockquote>
    <br>
    <pre class="moz-signature" cols="72">-- 
--

Tom Reijnders
TOR Informatica
Chopinlaan 27
5242HM Rosmalen
Tel: 073 5226191
Fax: 073 5226196

</pre>
  </body>
</html>