home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / documentation / documents / a252bug < prev    next >
Internet Message Format  |  1999-04-27  |  4KB
  1. From: aglover@acorn.co.uk (Alan Glover)
  2. Subject: Bugs without flames
  3. Date: 11 Nov 91 14:57:11 GMT
  4. Organization: Acorn Computers Ltd, Cambridge, England
  5.  
  6.  
  7. Ok, looks like it's time to try this again.
  8.  
  9. As someone remarked, this group is getting to look like alt.flame.acorn, so
  10. let's put all this energy to some constructive use instead .....
  11.  
  12. Below is the standard electronic form used within Acorn, and by external
  13. testers, to report faults in software or hardware.
  14.  
  15. Instead of flaming about a bug simply fill in as much as you can on the form
  16. below, (remembering that the stranger the bug, the more info will be needed
  17. to make it happen controllably), and email it to me. If a lot of supporting
  18. info is needed, it may be better to send a letter (possibly with
  19. accompanying disc) - address it to Customer Services, Acorn Computers Ltd.,
  20. Fulbourn Road, Cherry Hinton, Cambridge, CB1 4JN, UK. 
  21.  
  22. I will not acknowledge receipt unless requested to, or respond to anything
  23. flame-like, so don't bother sending it - just send the information needed to
  24. reproduce a bug.
  25.  
  26. To give you an idea of what is and is not useful:
  27.  
  28. a) Do this, do this, do this and it does this (which it shouldn't).
  29.  
  30.    Very useful, especially when 100% repeatable.
  31.  
  32. b) Do this, do this, and it sometimes does this.
  33.  
  34.    Try to quantify how often 'sometimes' is. Failures are never truly random
  35.    - try to identify what missing factor is needed to make the bug
  36.    thoroughly reproducable.
  37.  
  38. c) This is cr*p, and doesn't do x, y, z.
  39.  
  40.    Unless we said it should do x,y and z this is categorised as a change to
  41.    the specification of a product, and is only likely to happen if a number
  42.    of people agree with you. No product can be everything to all people!
  43.  
  44.    Avoid saying something is cr*p. It's inaccurate, irrelevant, and just
  45.    gets people wound up.
  46.  
  47. d) X crashes all the time.
  48.  
  49.    Absolutely useless :-). Obviously it didn't do it for us during testing
  50.    or it would never have got released. Gradually eliminate elements of
  51.    your working environment until you find the source of the clash (which is
  52.    a typical reason for this). If you don't manage to localise if further,
  53.    turn your attention to any soft-loaded modules, and then to any Expansion
  54.    Cards.
  55.  
  56. Please note: The fact that bugs exist (or are alleged to exist) in a product
  57. is no guarantee that a new version will be released, or that the alleged bug
  58. will be fixed. 
  59.  
  60. Most of the fields are self explanatory, but here are some brief notes:
  61.  
  62. App. version number - from the Info Box, or from a module where appropriate.
  63.  
  64. Exact Hardware Config - be exact ! Include any expansion cards.
  65.  
  66. ROM Version Number - 2.00, 2.01 (A540 only) or 3.00 (A5000 only).
  67.  
  68. Tester Email name - in full please
  69.  
  70. Test Number - a number of your own devising
  71.  
  72. Fault Number - will be filled in by us - leave it blank
  73.  
  74. Priority - your idea of seriousness - rate as Low, Medium or High
  75.  
  76. Summary - keep it to one line of <60 characters
  77.  
  78. Status - will be filled in by us - leave it blank
  79.  
  80. Date encountered - guess! :-)
  81.  
  82. Test and Fault description - be verbose but relevant !       
  83.  
  84.  
  85. If you feel some feature is missing from an Acorn product then use the same
  86. form, but make clear:
  87.  
  88. a) Why the feature should be provided, and exactly what it should do.
  89.  
  90. b) Who it would be useful to (ie, what groups of people).
  91.  
  92. Again, remember that this is not provided as a way to let off steam,
  93. objectivity is important!
  94.  
  95.  
  96. Alan
  97.                                                 
  98.  
  99. --- cut here ---
  100.  
  101. FAULT REPORT
  102.  
  103. Application Name:               
  104.  
  105. Application Version Number:     
  106.  
  107. Exact Hardware configuration:   
  108.  
  109. ROM Version Number:             
  110.  
  111. Tester Email Name:              
  112.  
  113. Test Number:                    
  114.  
  115. Fault Number:                   
  116.  
  117. Priority:                       
  118.  
  119. Summary: 
  120.  
  121. Status:                         
  122.  
  123. Date Encountered:               
  124.  
  125. Test and Fault Description:     
  126.  
  127. --- cut here ---
  128.  
  129. --------------------------------------------------------------------------
  130. aglover@acorn.co.uk - Moderator of comp.binaries.acorn/comp.sources.acorn
  131. Mail submissions to submit@acorn.co.uk, other mail to moderator@acorn.co.uk
  132.  
  133.  
  134.