<div dir="ltr"><br><div class="gmail_extra"><div class="gmail_quote">On Mon, Sep 26, 2016 at 12:17 PM, Bob Wilson <span dir="ltr"><<a href="mailto:rwilson@wisc.edu" target="_blank">rwilson@wisc.edu</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Just a couple of old-fogie thoughts... (These points came up in different threads, so saying "Re..." doesn't really work well.<br>
<br>
One of the bad things for manual construction was the development of documentation software. For this purpose I include everything from word processors through the various roffs and the like. </blockquote><div><br></div><div><br></div><div>The quality of documentation is critical to the success of a product.<br>It can take many forms and be built with many tools but it is necessary.<br><br></div><div>A number of years ago I was trying to learn enough php to get some things done.</div><div>My first five questions or so were not answered in the primary documents written</div><div>by engineers but were answers to user comments (questions and answers).   Any </div><div>largish project should look hard at the php model and tools. IMO.</div><div><br></div><div>At a unix company 25+ years ago some thought I was a wizard because I </div><div>picked up a script that built an "apropos" data base.   It took a couple</div><div>attempts and got it baked into the product.  The quality of questions</div><div>to the company engineering by customers, users, internals and others</div><div>including internal support staff went up.</div><div><br>If you invents something you need to teach others about it.<br>Without the education component you are inflicting an adventure</div><div>game with no gold coins on people trying to get things done.</div><div><br></div><div>The authors of Frank and Ernest understood some of this</div><div>better than most managers.<br><br>If you are an inventor meditate on this often.<br>If you invest in inventors meditate one this more often.<br><a href="http://www.thecomicstrips.com/store/add.php?iid=70205">http://www.thecomicstrips.com/store/add.php?iid=70205</a><br></div><div><span style="color:rgb(69,69,69);font-family:verdana,arial,helvetica,sans-serif;font-size:10px">"Look! I just invented writing! Thanks a lot! ... You just made everybody else in the world illiterate!"</span><br></div><div><br></div><div>Do not get lazy,   User forums are full of cruft.</div><div>Documentation should relentlessly improve.  </div><div>You do not want to allow any old edit.<br><a href="http://www.thecomicstrips.com/store/add.php?iid=57512">http://www.thecomicstrips.com/store/add.php?iid=57512</a><br>"<span style="color:rgb(69,69,69);font-family:verdana,arial,helvetica,sans-serif;font-size:10px">I'm not sure which, but he's just invented either writing or vandalism."</span><br><br></div></div>Tools are not magic but can tighten the turn around cycle.<br><br>Yes invent in quality authors and readers.</div><div class="gmail_extra">A good author can own the outside looking in perspective</div><div class="gmail_extra">in a company of engineers that own the inside looking</div><div class="gmail_extra">out view of the world.  <br>User interfaces begin as engineering check lists and often</div><div class="gmail_extra">reflect the internals of the project.   A user interface by</div><div class="gmail_extra">its nature will be different.  They can coexist.</div><div class="gmail_extra"><br></div><div class="gmail_extra"><br></div><div class="gmail_extra"><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr">  T o m    M i t c h e l l</div></div>
</div></div>