home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / busi / sprt109c.lzh / BETA.DOC next >
Text File  |  1990-09-18  |  15KB  |  429 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                      SPORT Wide Area Information Transfer System
  13.  
  14.  
  15.  
  16.                   Copyright 1988, 1989, 1990 Satore Center Software
  17.                        Copyright 1988, 1989, 1990 Big Science 
  18.  
  19.  
  20.  
  21.                            ===============================
  22.  
  23.                                Beta Release Information
  24.  
  25.                            ===============================
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.           BECOMING PART OF THE BETA TESTING PROCESS
  33.           =========================================
  34.  
  35.           In order to bring  SPORT into wide distribution,  it needs to  be
  36.           thoroughly tested in  the "real world", using the widest possible
  37.           variety of hardware  configurations. There are hundreds  of types
  38.           of  modems  on  the  market,  some  of  which  may  have  special
  39.           requirements  that  need  to  be  discovered and  documented.  In
  40.           general, beta testing needs to accomplish four tasks.
  41.  
  42.                1.) Trapping Technical  Errors. There are 100,000+  lines of
  43.                programming "code"  that make SPORT  do what it  does. There
  44.                are  bound  to be  errors in  the  workings of  the program,
  45.                because  every  single  combination  of  hardware and  usage
  46.                cannot be foreseen.
  47.  
  48.                2.) Clarity of Documentation. Although every effort is being
  49.                made  to   make   the   explanatory   manuals   clear,   the
  50.                understandablity of the documentation, both  in language and
  51.                organization needs to be reviewed.
  52.  
  53.                3.) Forms of Use. SPORT has been designed to be flexible and
  54.                meet any kind  of communication need.  Now, put into  actual
  55.                use, and the advantages, problems and suggested improvements
  56.                should be reflected back to the program designers.
  57.  
  58.                4.)  Marketing Suggestions.  Ideas  for  the  promotion  and
  59.                distribution of the SPORT package are welcomed.
  60.  
  61.  
  62.           SPORT - Beta Test Document                                 Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.           WHAT YOU WILL NEED
  72.           ==================
  73.  
  74.           Beta Test Sites  need a computer with  at least 640K RAM,  a hard
  75.           disk,  a modem  and a  phone line.  The computer  should be  left
  76.           running all the time. 
  77.  
  78.           SPORT  may be run  in the background  with Multi-Tasking programs
  79.           such as Desqview (c). We can help you set up to work in that
  80.           environment. SPORT will work in a 284K window.
  81.  
  82.  
  83.           HOW WE ARE ORGANIZED
  84.           ====================
  85.  
  86.           Because SPORT provides the easiest  kind of communication between
  87.           PC's, and can  send, receive and process  messages automatically,
  88.           the bulk  of the testing process can  be done by Electronic Mail.
  89.           Because SPORT is designed to be flexible, we will set up networks
  90.           as we go.  (The "topography" of these  networks is a part  of the
  91.           software development process.) 
  92.  
  93.           There will  be several Beta  Test areas,  each with  a Beta  Test
  94.           Coordinator. The  Overall Beta  Coordinator is  Bob Ernstthal  at
  95.           Augustine  Associates. When you run SIGNUP,  his address is added
  96.           to your Phone Index List as SIGNUP and SPORTDOC.
  97.  
  98.           Our Beta  Sites will  represent a  range of  computer experience,
  99.           including  novice  users.  We  will  do  our best  to  accomodate
  100.           everyone's  schedule  and  responsibilities. The  writer  of  the
  101.           program,   Satore  Center   Software,   and  the   designer   and
  102.           documentation writer, Bob  Ernstthal appreciate the   effort that
  103.           goes into the testing.
  104.  
  105.           We will ask you for a list of  the hardware you are running SPORT
  106.           on; make, model,  drives, configuration, speeds, etc. Part of the
  107.           testing cycle will  involve running SPORT with  as many different
  108.           types of hardware as possible.
  109.  
  110.  
  111.           We are maintaining  a very important SPORT  conference especially
  112.           for  Beta  Testers and  other  interested parties  on  the Satore
  113.           Center BBS. We urge you to  participate, bring your questions and
  114.           concerns there. Satore Center is run  by the programmer of SPORT,
  115.           so it is  the only forum to  get a personal response  from him to
  116.           your inquiries.
  117.  
  118.           The Satore Center BBS number is (415) 753-3356.
  119.  
  120.           We hope to meet you there!
  121.  
  122.  
  123.           SPORT - Beta Test Document                                 Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.           The criteria for being a site is interest, not experience. As the
  132.           tests progresses, you will  be provided with new versions  of the
  133.           software, which will incorporate bug fixes and suggested changes.
  134.           These new versions should not affect your set-up, but we will ask
  135.           you to update your program files when necessary. 
  136.  
  137.           Beta testers are asked to be flexible, and to stay loose. Part of
  138.           the fun and  frustration of  testing is that  things will  change
  139.           from time to time. Communication between test sites and test site
  140.           coordinators is essential.
  141.  
  142.           CATCHING BUGS
  143.           =============
  144.  
  145.           We are all used to working with software that simply does certain
  146.           things, shows up on the screen in a certain way and is always
  147.           predictable. These programs have already gone through many cycles
  148.           of  testing by experts  and by novices.  From time to  time a new
  149.           version  will  be  released including  updates  and  changes. Our
  150.           testing will be like this, only the original and updated versions
  151.           are distributed privately to our test sites. Being a tester means
  152.           you get to help produce the inital release product. 
  153.  
  154.  
  155.           1.) Trapping Technical Errors.
  156.           ------------------------------
  157.  
  158.           We need you  to find the flaws,  things that do not  work as they
  159.           are supposed to. We must first make sure it is not user error, or
  160.           attributable to hardware problems. The Beta Test Coordinators can
  161.           help you with the  initial error analysis. The error  needs to be
  162.           reproducable.
  163.  
  164.           Testers  will  be  unable  to  tell  the gravity  of  the  error.
  165.           Sometimes what seems minor to you will lead us to a major flaw in
  166.           the code. Sometimes what seems to be a major problem only takes a
  167.           very small adjustment to rectify. You do not have to evaluate the
  168.           nature of the flaws, we are only asking you to report them.
  169.  
  170.           If your system "hangs up" or stops working, remember that you can
  171.           always cold reboot to reset your system.
  172.  
  173.           We do ask you to describe the errors and problems you find with
  174.           precision. Not only what happens, but exactly what you were doing
  175.           before it happened. Your  SPORT.LOGs will help, but we  will need
  176.           to know the context of the error.  Can you duplicate it? The kind
  177.           of precision we  need may take some practice  for you to develop,
  178.           but it is crucial if we are to make the program bug-free.
  179.  
  180.           The SPORT.LOG is automatically created and will show the activity
  181.           on your system. This log is  written into your SPORT subdirectory
  182.           automatically.
  183.  
  184.           SPORT - Beta Test Document                                 Page 3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.           The current SPORT.LOG will be  automatically renamed at midnight,
  194.           if there is no other event happening. Thus, on 10/12/90, the  log
  195.           file, at midnight, will become 10120000.LOG, and a new  SPORT.LOG
  196.           file will start.
  197.  
  198.           We do not have to  see your Log file(s) unless something  unusual
  199.           happens. Please keep an eye on them and be ready to save and send
  200.           it in  if there is  something noteworthy.   There is a  provision
  201.           from the Utilities  Menu to insert a  comment line into  the Log.
  202.           This  will be  very  useful for  us  to keep  an  eye on  special
  203.           problems. Please try to become familiar with your Log and what it
  204.           shows.
  205.  
  206.           The log files  will accumulate,  and should be  deleted at  least
  207.           when a new version is installed.
  208.  
  209.           Mailer programs  are extremely  complex. Trying  to pinpoint  and
  210.           root out errors  is a  large, brain-straining task.  That is  why
  211.           precision in reporting of errors is the key.
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.           Here is a the "Bug Report" format we are using:
  219.  
  220.  
  221.  
  222.                                  SPORT Beta Site Bug Report
  223.                                  --------------------------
  224.  
  225.           Please address this report to SPORTDOC.   Please also file-attach
  226.           any samples, log file  fragments or explanatory  notes  which may
  227.           help  in tracking down  the problem.   The more specific  the bug
  228.           report, the more opportunity we will have to correct the problem.
  229.           A message file becoming "BAD'  is not necessarily anything wrong,
  230.           it just indicates a "fail to  synch". However, you should examine
  231.           the circumstance which, if repeated, could indicate a problem.
  232.  
  233.           You may use this format to create a text file with  your favorite
  234.           text editor. Just  complete the areas  indicated and forward  the
  235.           report.  
  236.  
  237.           Please rename this  file with your  name and the extension  .BUG,
  238.           and file-attach it  to a message  addressed to SPORTDOC.   Please
  239.           produce this report in ASCII format so we can process it.
  240.  
  241.  
  242.  
  243.  
  244.  
  245.           SPORT - Beta Test Document                                 Page 4
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.                   [---------  Please complete this area ---------]
  254.  
  255.           Your Name and Net/Node     :
  256.  
  257.           Version of SPORT in use    :
  258.  
  259.           Date bug was first noticed :
  260.  
  261.           Module in which bug appears:   ___ Mailer    ___ Terminal 
  262.  
  263.                                          --- Utility   --- SFLASH
  264.  
  265.                                          ___ SPORTU    ___ SPREP  
  266.  
  267.                                          ___ SPORTRM   --- SPORTY
  268.  
  269.                                          --- SPORTEX   --- Other
  270.           If "Other" please explain  :
  271.  
  272.           Please describe the bug    :
  273.                                      :
  274.                                      :
  275.                                      :
  276.                                      :
  277.                                      :
  278.                                      :
  279.                                      :
  280.                                      :
  281.           Can you duplicate the error:   ___ Yes       ___ No    
  282.  
  283.                                          --- Irregular
  284.  
  285.           Do you have a "work around":   ___ Yes       ___ No
  286.  
  287.           If "Yes" please explain    :
  288.                                      :
  289.                                      :
  290.                                      :
  291.                                      :
  292.                                      :
  293.           Other comments/suggestions :
  294.                                      :
  295.                                      :
  296.                                      :
  297.                                      :                           
  298.                                      :
  299.           - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  300.           Although we  do not  answer every  bug report,   we do  carefully
  301.           review each one.  We may ask  you for a  fuller explanation of  a
  302.           particular situation. Our next release  will address any problems
  303.           which  we  are  able to  correct.  We  appreciate  your help  and
  304.           participation.
  305.  
  306.           SPORT - Beta Test Document                                 Page 5
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.           2.) Clarity of Documentation.
  317.  
  318.           Ongoing changes are made in  the documentation. Periodically, new
  319.           versions  are released.  We are  happy to  receive messages  with
  320.           suggestions and corrections to the documentation through the Test
  321.           Site Coordinators.  Just like  debugging the  software, the  more
  322.           specific you can be, the more helpful it is.
  323.  
  324.  
  325.           3.) Forms of Use.
  326.  
  327.           We would like  to collect from  Test Site Coordinators the  forms
  328.           and methods of the communications networks  and the uses to which
  329.           they are put. 
  330.  
  331.           Please play with  SPORT. Use  its features, call  Data Bases  and
  332.           Bulletin Boards,  up  and  download files,  send  mail  to  other
  333.           testers. You will be given special access to Satore Center BBS. 
  334.  
  335.           We would like you to use the EVENT feature to set up calls to
  336.           other testers. You will be apprised of new testers; their names,
  337.           numbers and hours of operation.
  338.  
  339.  
  340.           Each  Beta  group will  set  up  and trade  preferred  methods of
  341.           addressing  each other.  With SPORT,  it is  possible  to address
  342.           messages to "aliases"  instead of just phone  numbers or net/node
  343.           numbers. But,  if you  want to send  mail to  "Bob", I  must have
  344.           "Bob.FLS" indicated in  the "infile"  section of my  RAW file  so
  345.           that when a  message addressed to " Bob", is received, it will be
  346.           placed in my Library, and not remain in my inbound area.
  347.  
  348.           As you become more familiar with  SPORT you may be asked to  look
  349.           into the  SPORTEX Remote  Programming  capabilities,  and set  up
  350.           routed conference  type mail  using the  routing capabilities  of
  351.           SPORT.
  352.  
  353.           We will also test the Remote  Access capability, which allows you
  354.           to perform  certain functions your system remotely, and we'll run
  355.           tests of the  Remote Mail  capability, which will  permit you  to
  356.           send mail and read mail in your Library from a remote site.
  357.  
  358.  
  359.           4.) Marketing.
  360.  
  361.           Any kind of comments, suggestions and  referrals in this area are
  362.           welcomed. We will  circulate drafts of  texts we are planning  to
  363.           use in this context.
  364.  
  365.  
  366.  
  367.           SPORT - Beta Test Document                                 Page 6
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.           SPORT - Beta Test Document                                 Page 7
  429.