<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="">I think the advanced user definition maybe too restrictive.<div class=""><br class=""></div><div class="">Our current user base is perhaps best described as:</div><div class=""><br class=""></div><div class=""><ul class="MailOutline"><li class="">A science-based hobbyist (electronics, computers, etc)</li><li class="">Able to work with computers and electronics</li><li class="">Understands the core underlying technology</li></ul></div><div class=""><br class=""></div><div class="">A not-so-capable user can still use our system, but requires someone with the above capabilities to help setup and provide local support.</div><div class=""><br class=""></div><div class="">Regards, Mark.<br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On 5 Jan 2019, at 2:05 AM, Robert Sharpe (Electric Vehicle Consultant) <<a href="mailto:robert.sharpe@evergreen-consulting.co.uk" class="">robert.sharpe@evergreen-consulting.co.uk</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><meta content="text/html;charset=UTF-8" http-equiv="Content-Type" class=""><div class=""><div style="font-size:10pt;font-family:Verdana,Arial,Helvetica,sans-serif;color:#00000;" class=""><div class="">Hi Michael,<br class=""></div><div class=""><br class=""></div><div class="zmail_extra"><div id="Zm-_Id_-Sgn1" class=""><div class="">Thanks for your excellent points.<br class=""></div><div class=""><br class=""></div><div class="">In terms of suggested actions does the following accurately summarise your thoughts (with redline changes) summary?<br class=""></div><div class=""><br class=""></div></div><blockquote style="border-left: 1px solid #cccccc; padding-left: 6px; margin:0 0 0 5px" class=""><blockquote class=""><div style="font-size: 10pt; font-family: Verdana, Arial, Helvetica, sans-serif" class=""><div class="">User Definition<br class=""></div><ul class=""><li class="">a general household DIY capable person.<br class=""></li><li class="">can mount and plug things into the vehicle<br class=""></li><li class=""><span class="colour" style="color:rgb(255, 0, 0)">will only read</span><br class=""></li><ul class=""><li class=""><span class="colour" style="color:rgb(255, 0, 0)">a single quick install sheet</span><br class=""></li><li class=""><span class="colour" style="color:rgb(255, 0, 0)">a list of text commands</span><br class=""></li><li class=""><span class="colour" style="color:rgb(255, 0, 0)">maybe 3 min youTube videos</span><br class=""></li></ul><li class="">cant<br class=""></li><ul class=""><li class="">create connectors/leads<br class=""></li><li class="">modify the OVMS hardware<br class=""></li><li class="">don't know about internal or technical terms, such as Nissan Leaf GIDs, WiFi SSID, etc<br class=""></li></ul></ul><div class="">User Expectations<br class=""></div><ul class=""><li class="">the unit fully supports the listed features under all reasonable conditions<br class=""></li><li class="">reliable in operation<br class=""></li><li class="">error messages are non-technical and help the user solve the problem<br class=""></li><li class="">should be plug-n-play where possible, eg<br class=""></li><ul class=""><li class="">automatically detects vehicle type and year<br class=""></li><li class="">automatically detects battery capacity, etc<br class=""></li></ul></ul></div></blockquote></blockquote></div><div class=""><span class="colour" style="color:rgb(255, 0, 0)"> Rename User Manual to "Advanced User Manual"</span><br class=""></div><div class=""><br class=""></div><div class=""><span class="colour" style="color:rgb(255, 0, 0)"> Advanced User Definition</span><span class="colour" style="color:rgb(255, 0, 0)"></span><br class=""></div><div class="zmail_extra"><blockquote style="border-left: 1px solid #cccccc; padding-left: 6px; margin:0 0 0 5px" class=""><blockquote class=""><div style="font-size: 10pt; font-family: Verdana, Arial, Helvetica, sans-serif" class=""><ul class=""><li class=""><span class="colour" style="">can</span><span class="colour" style=""><br class=""></span></li><ul class=""><li class=""><span class="colour" style="">create connectors/leads</span><span class="colour" style=""><br class=""></span></li><li class=""><span class="colour" style="">modify the OVMS hardware (eg add wake-up hardware)</span><span class="colour" style=""><br class=""></span></li><li class=""><span class="colour" style="">modifying car at module level (eg remove TCU on Leaf)</span><span class="colour" style=""><br class=""></span></li><li class=""><span class="colour" style="">knows internal or technical terms, such as Nissan Leaf GIDs, WiFi SSID, etc</span><br class=""></li></ul></ul><div class=""><span class="colour" style="color:rgb(255, 0, 0)">Advanced User Expectations</span><br class=""></div><ul class=""><li class=""><span class="colour" style="color:#ff0000">to easily access detailed reasons why a feature doesn't work and possible workarounds</span><br class=""></li></ul></div></blockquote></blockquote><div id="Zm-_Id_-Sgn1" class=""><div class=""><br class=""></div></div><div id="Zm-_Id_-Sgn1" class=""><div class="">Rob<br class=""></div><div class=""><br class=""></div><div class="">--- On Fri, 04 Jan 2019 14:13:43 +0000 <b class="">Michael Balzer <<a href="mailto:dexter@expeedo.de" target="_blank" class="">dexter@expeedo.de</a>></b> wrote ----<br class=""></div><div class=""><br class=""></div></div><blockquote style="border-left: 1px solid #cccccc; padding-left: 6px; margin:0 0 0 5px" class=""><div class=""><div class="">Rob,<br class=""></div><div class=""><br class=""></div><div class="">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 class=""></div><div class=""><br class=""></div><div class="">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 class=""></div><div class=""><br class=""></div><div class=""><span id="cid:0.28869202780.205638962224749768.1681a0977d5__inline__img__src"><1.jpg></span><br class=""></div><div class=""><br class=""></div><div class=""><br class=""></div><div class="">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 class=""></div><div class=""><br class=""></div><div class="">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 class=""></div><div class=""><br class=""></div><div class="">But the manual IMO is meant for the capable / advanced user trying to get specific jobs done with the system.<br class=""></div><div class=""><br class=""></div><div class="">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 class=""></div><div class=""><br class=""></div><div class="">Regards,<br class=""></div><div class="">Michael<br class=""></div><div class=""><br class=""></div><div class=""><br class=""></div><div class=""><br class=""></div><div class="">Am 03.01.19 um 16:05 schrieb Robert Sharpe (Electric Vehicle Consultant):<br class=""></div><div class=""><br class=""></div><div class=""><br class=""></div><pre class="">--
Michael Balzer * Helkenberger Weg 9 * D-58256 Ennepetal
Fon 02333 / 833 5735 * Handy 0176 / 206 989 26
<br class=""></pre><div class="">_______________________________________________<br class=""></div><div class="">OvmsDev mailing list <br class=""></div><div class=""><a href="mailto:OvmsDev@lists.openvehicles.com" target="_blank" class="">OvmsDev@lists.openvehicles.com</a> <br class=""></div><div class=""><a href="http://lists.openvehicles.com/mailman/listinfo/ovmsdev" target="_blank" class="">http://lists.openvehicles.com/mailman/listinfo/ovmsdev</a> <br class=""></div></div><blockquote class=""><div style="font-size: 10pt; font-family: Verdana, Arial, Helvetica, sans-serif" class=""><div class="">Hi Mark/All,<br class=""></div><div class=""><br class=""></div><div class="">Sometime ago I did lots of obvious updates of the User Manual to help readability, etc as a first stab.<br class=""></div><div class=""><br class=""></div><div class="">Now doing a second stab, there is one thing that has come to light and that is the definition of a user.<br class=""></div><div class=""><br class=""></div><div class="">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 class=""></div><div class=""><br class=""></div><div class="">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 class=""></div><div class=""><br class=""></div><div class="">User Definition<br class=""></div><ul class=""><li class="">a general household DIY capable person.<br class=""></li><li class="">can mount and plug things into the vehicle<br class=""></li><li class="">cant<br class=""></li><ul class=""><li class="">create connectors/leads<br class=""></li><li class="">modify the OVMS hardware<br class=""></li><li class="">don't know about internal or technical terms, such as Nissan Leaf GIDs, WiFi SSID, etc<br class=""></li></ul></ul><div class="">User Expectations<br class=""></div><ul class=""><li class="">the unit fully supports the listed features under all reasonable conditions<br class=""></li><li class="">reliable in operation<br class=""></li><li class="">error messages are non-technical and help the user solve the problem<br class=""></li><li class="">should be plug-n-play where possible, eg<br class=""></li><ul class=""><li class="">automatically detects vehicle type and year<br class=""></li><li class="">automatically detects battery capacity, etc<br class=""></li></ul></ul><div class="">Please let me know if this is accurate or what changes/clarifications need to be made.<br class=""></div><div class=""><br class=""></div><div class="">Rob<br class=""></div><div class="zmail_extra"><div class=""><div class=""><br class=""></div><div class=""><br class=""></div><div class="">--- On Tue, 07 Aug 2018 03:30:33 +0100 <b class="">Mark Webb-Johnson <<a target="_blank" href="mailto:mark@webb-johnson.net" class="">mark@webb-johnson.net</a>></b> wrote ----<br class=""></div></div><div class=""><br class=""></div><blockquote style="border-left: 1px solid rgb(204, 204, 204); padding-left: 6px; margin: 0 0 0 5px" class=""><div style="" class=""><div class="">Robert,<br class=""></div><div class=""><br class=""></div><div class="">Thanks for the offer to help out.<br class=""></div><div class=""><br class=""></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 class=""></div><div class=""><br class=""></div><div class=""><div class="">Regards, Mark.<br class=""></div><div class=""><div class=""><br class=""></div><blockquote class=""><div class="">On 3 Aug 2018, at 4:01 PM, Robert Sharpe (Electric Vehicle Consultant) <<a target="_blank" href="mailto:robert.sharpe@evergreen-consulting.co.uk" class="">robert.sharpe@evergreen-consulting.co.uk</a>> wrote:<br class=""></div><div class=""><br class=""></div><div class=""><div class=""><div style="font-size: 10pt; font-family: Verdana, Arial, Helvetica, sans-serif" class=""><div class="">Hi All,<br class=""></div><div class=""><br class=""></div><div class="">I like where OVMS project is going and would like to help if I can.<br class=""></div><div class=""><br class=""></div><div class="">Where I can possibly add value is<br class=""></div><ul class=""><li class="">make things easy for people to use (eg documentation, etc)<br class=""></li><li class="">experienced on UI/UX design, etc.<br class=""></li><li class="">as an ex developer, good at testing and finding problems.<br class=""></li></ul><div class="">Some initial thoughts on activities are<br class=""></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 class=""></li><li class="">to help people see roadmap, provide a mechanism to see who wants what and who is working on it.<br class=""></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 class=""></li><li class="">update GITHUB readmes to better direct people that find GITHUB first.<br class=""></li></ul><div class="">Please<br class=""></div><ul class=""><li class="">let me know if anyone is dealing with any of these areas<br class=""></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 class=""></li></ul><div class=""><div style="font-family: Verdana, Arial, Helvetica, sans-serif" class=""><div style="font-family: verdana, arial, helvetica, sans-serif; background-color: rgb(255, 255, 255)" class=""><p style="" class=""><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 style="" class=""><span class="size" style="font-size:13.6364px"><a target="_blank" href="http://www.linkedin.com/in/arsharpe" class=""><span class=""><1.gif></span></a> <a target="_blank" href="http://www.twitter.com/EgcTechnical" class=""><span class=""><2.gif></span></a> <a target="_blank" href="https://www.facebook.com/EvergreenConsultingLtd" class=""><span class=""><3.gif></span></a> <a target="_blank" href="http://www.evergreen-consulting.co.uk/staff/skype/rsharpe.html" class=""><span class=""><4.gif></span></a> <a target="_blank" href="http://www.evergreen-consulting.co.uk/staff/calendars/rsharpe.html?utm_campaign=General&utm_source=EmailFooter&utm_medium=Email" class=""><span class=""><5.gif></span></a></span><br class=""></p><p style="" class=""><span class="size" style="font-size:13.6364px"><a target="_blank" href="http://www.evergreen-consulting.co.uk/?utm_campaign=General&utm_source=EmailFooter&utm_medium=Email" class=""><span class=""><6.png></span> </a></span><br class=""></p><p style="" class=""><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 class=""></p><p style="" class=""><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 class=""></p></div></div><div style="left: 8px; top: 19.25px; min-height: 92px; width: 200px" class=""><br class=""></div><div class=""><span style="top: 326px; left: 206px; cursor: e-resize" class=""></span><span style="top: 326px; left: 6px" class=""></span><span style="top: 278px; left: 108px; cursor: n-resize" class=""></span><span style="top: 370px; left: 108px; cursor: s-resize" class=""></span><br class=""></div></div><div class=""><br class=""></div></div><div class=""><br class=""></div></div><div class="">_______________________________________________<br class=""></div><div class="">OvmsDev mailing list<br class=""></div><div class=""><a target="_blank" href="mailto:OvmsDev@lists.openvehicles.com" class="">OvmsDev@lists.openvehicles.com</a><br class=""></div><div class=""><a target="_blank" href="http://lists.openvehicles.com/mailman/listinfo/ovmsdev" class="">http://lists.openvehicles.com/mailman/listinfo/ovmsdev</a><br class=""></div></div></blockquote></div><div class=""><br class=""></div></div><div class="">_______________________________________________ <br class=""></div><div class="">OvmsDev mailing list <br class=""></div><div class=""><a target="_blank" href="mailto:OvmsDev@lists.openvehicles.com" class="">OvmsDev@lists.openvehicles.com</a> <br class=""></div><div class=""><a target="_blank" href="http://lists.openvehicles.com/mailman/listinfo/ovmsdev" class="">http://lists.openvehicles.com/mailman/listinfo/ovmsdev</a> <br class=""></div></div></blockquote></div><div class=""><br class=""></div></div><div class=""><br class=""></div><div class=""><br class=""></div><pre class="">_______________________________________________
OvmsDev mailing list
<a href="mailto:OvmsDev@lists.openvehicles.com" target="_blank" class="">OvmsDev@lists.openvehicles.com</a>
<a href="http://lists.openvehicles.com/mailman/listinfo/ovmsdev" target="_blank" class="">http://lists.openvehicles.com/mailman/listinfo/ovmsdev</a>
<br class=""></pre></blockquote></blockquote></div><div class=""><br class=""></div></div><br class=""></div>_______________________________________________<br class="">OvmsDev mailing list<br class=""><a href="mailto:OvmsDev@lists.openvehicles.com" class="">OvmsDev@lists.openvehicles.com</a><br class="">http://lists.openvehicles.com/mailman/listinfo/ovmsdev<br class=""></div></blockquote></div><br class=""></div></body></html>