<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body text="#000000" bgcolor="#FFFFFF">
    Rob,<br>
    <br>
    maybe I'm too pessimistic (realistic?), but if you're targeting
    users within that category, your spec lacks "doesn't like reading
    manuals or searching the web for answers" and "likes watching short
    videos", so working on the manual with these users in mind is
    futile.<br>
    <br>
    My last App support: the App told the user it can't connect to the
    server, he should verify the server address and vehicle ID. I sent
    him the data he should use. He insisted in having entered exactly
    that. After four or five mails I finally got him to send me this
    "screenshot":<br>
    <br>
    <img src="cid:part1.73DC47D8.6F2298BC@expeedo.de" alt=""><br>
    <br>
    <br>
    Many current users (even v2 users) I have supported fit into that
    category, none of them would (could) read anything longer than a few
    sentences. The manual introduction section is already too much for
    them, they normally just jump into using the system and they
    normally fail at things like entering a server name or password
    correctly.<br>
    <br>
    Of course we should generally try to further simplify the UIs, e.g.
    provide a select option for the standard servers and an account
    registration API.<br>
    <br>
    But the manual IMO is meant for the capable / advanced user trying
    to get specific jobs done with the system.<br>
    <br>
    For the "low end" user target, a single (!) page "first setup" sheet
    is needed, and a series of 3 minute feature introduction videos on
    Youtube.<br>
    <br>
    Regards,<br>
    Michael<br>
    <br>
    <br>
    <div class="moz-cite-prefix">Am 03.01.19 um 16:05 schrieb Robert
      Sharpe (Electric Vehicle Consultant):<br>
    </div>
    <blockquote type="cite"
cite="mid:168143ec8a3.ad60801d178250.298651852234293416@evergreen-consulting.co.uk">
      <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
      <div
style="font-size:10pt;font-family:Verdana,Arial,Helvetica,sans-serif;color:#00000;">
        <div>Hi Mark/All,<br>
        </div>
        <div><br>
        </div>
        <div>Sometime ago I did lots of obvious updates of the User
          Manual to help readability, etc as a first stab.<br>
        </div>
        <div><br>
        </div>
        <div>Now doing a second stab, there is one thing that has come
          to light and that is the definition of a user.<br>
        </div>
        <div><br>
        </div>
        <div>In order to check the documentation I need to know what the
          user is capable of off.  I appreciate that the definition of
          user has probably changed over the development of the project
          and the product has matured enough that it can be operated by
          non-technical users opening up its usefulness.  <br>
        </div>
        <div><br>
        </div>
        <div>Assuming that what were the original users would how fall
          into the category of Developers, does the following draft
          specification accurately reflect the minimum capabilities of a
          current/future User?<br>
        </div>
        <div><br>
        </div>
        <div>User Definition</div>
        <ul>
          <li>a general household DIY capable person.<br>
          </li>
          <li>can mount and plug things into the vehicle<br>
          </li>
          <li>cant<br>
          </li>
          <ul>
            <li>create connectors/leads<br>
            </li>
            <li>modify the OVMS hardware<br>
            </li>
            <li>don't know about internal or technical terms, such as
              Nissan Leaf GIDs, WiFi SSID, etc</li>
          </ul>
        </ul>
        <div>User Expectations<br>
        </div>
        <ul>
          <li>the unit fully supports the listed features under all
            reasonable conditions<br>
          </li>
          <li>reliable in operation</li>
          <li>error messages are non-technical and help the user solve
            the problem</li>
          <li>should be plug-n-play where possible, eg<br>
          </li>
          <ul>
            <li>automatically detects vehicle type and year<br>
            </li>
            <li>automatically detects battery capacity, etc<br>
            </li>
          </ul>
        </ul>
        <div>Please let me know if this is accurate or what
          changes/clarifications need to be made.<br>
        </div>
        <div><br>
        </div>
        <div>Rob</div>
        <div class="zmail_extra">
          <div id="Zm-_Id_-Sgn1">
            <div><br>
            </div>
            <div><br>
            </div>
            <div>--- On Tue, 07 Aug 2018 03:30:33 +0100 <b>Mark
                Webb-Johnson <<a target="_blank"
                  href="mailto:mark@webb-johnson.net"
                  moz-do-not-send="true">mark@webb-johnson.net</a>></b>
              wrote ----<br>
            </div>
          </div>
          <div><br>
          </div>
          <blockquote style="border-left: 1px solid #cccccc;
            padding-left: 6px; margin:0 0 0 5px">
            <div class="" style="">
              <div>Robert,<br>
              </div>
              <div class=""><br>
              </div>
              <div class="">Thanks for the offer to help out.<br>
              </div>
              <div class=""><br>
              </div>
              <div class="">Perhaps you can look at it from the user’s
                point of view, and try to improve our documentation and
                approach for that?<br>
              </div>
              <div class=""><br>
              </div>
              <div class="">
                <div>Regards, Mark.<br>
                </div>
                <div>
                  <div><br>
                  </div>
                  <blockquote class="">
                    <div class="">On 3 Aug 2018, at 4:01 PM, Robert
                      Sharpe (Electric Vehicle Consultant) <<a
                        target="_blank" class=""
                        href="mailto:robert.sharpe@evergreen-consulting.co.uk"
                        moz-do-not-send="true">robert.sharpe@evergreen-consulting.co.uk</a>>
                      wrote:<br>
                    </div>
                    <div><br>
                    </div>
                    <div class="">
                      <div class="">
                        <div class="" style="font-size: 10pt;
                          font-family: Verdana, Arial, Helvetica,
                          sans-serif">
                          <div class="">Hi All,<br>
                          </div>
                          <div class=""><br>
                          </div>
                          <div class="">I like where OVMS project is
                            going and would like to help if I can.<br>
                          </div>
                          <div class=""><br>
                          </div>
                          <div class="">Where I can possibly add value
                            is<br>
                          </div>
                          <ul class="">
                            <li class="">make things easy for people to
                              use (eg documentation, etc)<br>
                            </li>
                            <li class="">experienced on UI/UX design,
                              etc.<br>
                            </li>
                            <li class="">as an ex developer, good at
                              testing and finding problems.<br>
                            </li>
                          </ul>
                          <div class="">Some initial thoughts on
                            activities are<br>
                          </div>
                          <ul class="">
                            <li class="">to make it easier for non
                              technical people to use OVMS, help doc
                              author pull out user only specific content
                              to a user manual and make it non-technical
                              (renaming current user manual to
                              developers manual) <br>
                            </li>
                            <li class="">to help people see roadmap,
                              provide a mechanism to see who wants what
                              and who is working on it.<br>
                            </li>
                            <li class="">to allow developers and users
                              to display problems with their vehicle
                              only, add Labels to the github issues list
                              or group by project (I am not an expert on
                              GITHUB so please be patient)<br>
                            </li>
                            <li class="">update GITHUB readmes to better
                              direct people that find GITHUB first.<br>
                            </li>
                          </ul>
                          <div class="">Please<br>
                          </div>
                          <ul class="">
                            <li class="">let me know if anyone is
                              dealing with any of these areas<br>
                            </li>
                            <li class="">add and/or vote for what things
                              you think I can help with by putting a
                              comment next to the activity above.<br>
                            </li>
                          </ul>
                          <div class="" id="">
                            <div class="" style="font-family: Verdana,
                              Arial, Helvetica, sans-serif">
                              <div class="" style="font-family: verdana,
                                arial, helvetica, sans-serif;
                                background-color: rgb(255, 255, 255)">
                                <p class="" style=""><span class="size"
                                    style="font-size:13.6364px"><span
                                      class="font"
                                      style="font-family:Calibri,
                                      Verdana, Arial, sans-serif"><span
                                        class="size"
                                        style="font-size:16px">Regards,<br
                                          class="">
                                        Robert Sharpe<br class="">
                                        Electric Vehicle Consultant<br
                                          class="">
                                        07711 252971</span></span></span></p>
                                <p class="" style=""><span class="size"
                                    style="font-size:13.6364px"><a
                                      target="_blank" class=""
                                      href="http://www.linkedin.com/in/arsharpe"
                                      moz-do-not-send="true"><span><1.gif></span></a> <a
                                      target="_blank" class=""
                                      href="http://www.twitter.com/EgcTechnical"
                                      moz-do-not-send="true"><span><2.gif></span></a> <a
                                      target="_blank" class=""
                                      href="https://www.facebook.com/EvergreenConsultingLtd"
                                      moz-do-not-send="true"><span><3.gif></span></a> <a
                                      class="" target="_blank"
                                      href="http://www.evergreen-consulting.co.uk/staff/skype/rsharpe.html"
                                      moz-do-not-send="true"><span><4.gif></span></a> <a
                                      class="" target="_blank"
href="http://www.evergreen-consulting.co.uk/staff/calendars/rsharpe.html?utm_campaign=General&utm_source=EmailFooter&utm_medium=Email"
                                      moz-do-not-send="true"><span><5.gif></span></a></span><br>
                                </p>
                                <p class="" style=""><span class="size"
                                    style="font-size:13.6364px"><a
                                      class="" target="_blank"
href="http://www.evergreen-consulting.co.uk/?utm_campaign=General&utm_source=EmailFooter&utm_medium=Email"
                                      moz-do-not-send="true"><span><6.png></span> </a></span><br>
                                </p>
                                <p class="" style=""><span class="size"
                                    style="font-size:13.6364px"><span
                                      class="font"
                                      style="font-family:Calibri,
                                      Verdana, Arial, sans-serif"><span
                                        class="size"
                                        style="font-size:24px"><i
                                          class="">Your Plugged-in
                                          Partner</i></span></span></span><br>
                                </p>
                                <p class="" style=""><span class="size"
                                    style="font-size:13.6364px"><span
                                      class="font"
                                      style="font-family:Calibri,
                                      Verdana, Arial, sans-serif"><span
                                        class="size"
                                        style="font-size:13px">Evergreen
                                        Consulting is the trading name
                                        of Sharpe Consultants Ltd</span></span></span><br>
                                </p>
                              </div>
                            </div>
                            <div style="left: 8px; top: 19.25px;
                              min-height: 92px; width: 200px"
                              class="x_1034760407ze_ctrlgrid"><br>
                            </div>
                            <div class=""><span style="top: 326px; left:
                                206px; cursor: e-resize"
                                class="x_1034760407ze_resize-ctrl-grid"></span><span
                                style="top: 326px; left: 6px"
                                class="x_1034760407ze_resize-ctrl-grid"></span><span
                                style="top: 278px; left: 108px; cursor:
                                n-resize"
                                class="x_1034760407ze_resize-ctrl-grid"></span><span
                                style="top: 370px; left: 108px; cursor:
                                s-resize"
                                class="x_1034760407ze_resize-ctrl-grid"></span><br>
                            </div>
                          </div>
                          <div class=""><br>
                          </div>
                        </div>
                        <div><br>
                        </div>
                      </div>
                      <div>_______________________________________________<br>
                      </div>
                      <div>OvmsDev mailing list<br>
                      </div>
                      <div><a target="_blank" class=""
                          href="mailto:OvmsDev@lists.openvehicles.com"
                          moz-do-not-send="true">OvmsDev@lists.openvehicles.com</a><br>
                      </div>
                      <div><a target="_blank"
                          href="http://lists.openvehicles.com/mailman/listinfo/ovmsdev"
                          moz-do-not-send="true">http://lists.openvehicles.com/mailman/listinfo/ovmsdev</a><br>
                      </div>
                    </div>
                  </blockquote>
                </div>
                <div><br>
                </div>
              </div>
              <div>_______________________________________________ <br>
              </div>
              <div>OvmsDev mailing list <br>
              </div>
              <div><a target="_blank"
                  href="mailto:OvmsDev@lists.openvehicles.com"
                  moz-do-not-send="true">OvmsDev@lists.openvehicles.com</a>
                <br>
              </div>
              <div><a target="_blank"
                  href="http://lists.openvehicles.com/mailman/listinfo/ovmsdev"
                  moz-do-not-send="true">http://lists.openvehicles.com/mailman/listinfo/ovmsdev</a>
                <br>
              </div>
            </div>
          </blockquote>
        </div>
        <div><br>
        </div>
      </div>
      <br>
      <br>
      <fieldset class="mimeAttachmentHeader"></fieldset>
      <pre class="moz-quote-pre" wrap="">_______________________________________________
OvmsDev mailing list
<a class="moz-txt-link-abbreviated" href="mailto:OvmsDev@lists.openvehicles.com">OvmsDev@lists.openvehicles.com</a>
<a class="moz-txt-link-freetext" href="http://lists.openvehicles.com/mailman/listinfo/ovmsdev">http://lists.openvehicles.com/mailman/listinfo/ovmsdev</a>
</pre>
    </blockquote>
    <br>
    <pre class="moz-signature" cols="160">-- 
Michael Balzer * Helkenberger Weg 9 * D-58256 Ennepetal
Fon 02333 / 833 5735 * Handy 0176 / 206 989 26
</pre>
  </body>
</html>