home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 10 / Fresh_Fish_10_2352.bin / useful / reviews / doc / rcs / template,v < prev    next >
Text File  |  1994-11-08  |  10KB  |  363 lines
  1. head    1.2;
  2. access;
  3. symbols;
  4. locks
  5.     barrett:1.2; strict;
  6. comment    @# @;
  7.  
  8.  
  9. 1.2
  10. date    94.11.08.15.15.36;    author barrett;    state Exp;
  11. branches;
  12. next    1.1;
  13.  
  14. 1.1
  15. date    94.06.24.21.49.33;    author barrett;    state Exp;
  16. branches;
  17. next    ;
  18.  
  19.  
  20. desc
  21. @@
  22.  
  23.  
  24. 1.2
  25. log
  26. @*** empty log message ***
  27. @
  28. text
  29. @            COMP.SYS.AMIGA.REVIEWS
  30.                        Template For Full Reviews
  31.               (Optional but recommended)
  32.                     Last modified November 8, 1994
  33.  
  34.     Do you need help organizing or writing a full review?  Then you are
  35. welcome to use this "template" file as a guide.  It contains common subject
  36. headings, common questions you can answer, and other information.  Just
  37. "fill in the blanks" to write your review.
  38.  
  39.     Before you use this Template, make sure you have the most recent
  40. version!  If it is more than 2 months old, ftp to math.uh.edu and look in the
  41. directory /pub/Amiga/comp.sys.amiga.reviews/doc, or send mail to
  42. amiga-reviews-requests@@math.uh.edu and ask for the most recent version.
  43.  
  44. [Note:  Please see the article "Introduction to comp.sys.amiga.reviews" for
  45. full information about writing a review.  A "full review" is not the only
  46. kind of review you can write.  The "Introduction" article is posted in
  47. comp.sys.amiga.reviews on the first day of every month.]
  48.  
  49.     You are NOT REQUIRED to use this template; however, I recommend that
  50. you read it anyway.  It might give you some ideas for what to write, or
  51. remind you of something you have forgotten.
  52.  
  53.     The template consists of headings (in ALL CAPITAL LETTERS)
  54. and comments <<inside brackets like this>>.  To use the template,
  55. simply delete the comments and replace them with your review information.
  56. Do not delete the headings; leave them in your finished review.
  57.  
  58.     You do not have to use every heading, but try to use all of them
  59. that apply to your product.  Also, you may certainly add your own headings.
  60.  
  61.     When your review is finished, mail it to
  62.  
  63.         amiga-reviews-submissions@@math.uh.edu
  64.  
  65. If you have any suggestions or corrections for this template, send them
  66. to amiga-reviews@@math.uh.edu.
  67.  
  68. ------------8<----------------- cut here ----------------8<------------------
  69.  
  70. PRODUCT NAME
  71.  
  72.     <<The name of the product, and the version number.>>
  73.  
  74.  
  75. BRIEF DESCRIPTION
  76.  
  77.     <<1 or 2 sentences describing what kind of product this is.>>
  78.  
  79.     <<Please do not quote from the manual here.  Use your own words.
  80.     Manuals often contain hype about what a product does.>>
  81.  
  82.  
  83. AUTHOR/COMPANY INFORMATION
  84.  
  85.     Name:        <<...>>
  86.     Address:    <<...>>
  87.  
  88.     Telephone:    <<...>>
  89.     FAX:        <<...>>
  90.  
  91.     E-mail:        <<...>>
  92.  
  93.  
  94.     <<If the telephone number is an "800" toll-free number, and you
  95.       live in the USA or Canada, please call it and ask for a
  96.       non-800 number for our international friends to use.>>
  97.  
  98.  
  99. LIST PRICE
  100.  
  101.     <<The list price of the product.  Remember to say what currency
  102.     units you are using (US dollars, Canadian dollars, francs, ...).>>
  103.  
  104.     <<Optionally, you may also include the price you paid,
  105.     but do not advertise for any particular store!>>
  106.  
  107.  
  108. SPECIAL HARDWARE AND SOFTWARE REQUIREMENTS
  109.  
  110.     <<Does your Amiga require any special hardware or software before
  111.     you can use the product?>>
  112.  
  113.     <<Keep your comments brief so they are easy for the reader to scan
  114.     quickly.  (But go into detail if it is necessary!  Don't sacrifice
  115.     accuracy.)  For example, instead of writing:
  116.  
  117.         The Whizbang Amiga Gadget requires at least 2 megabytes of
  118.         Fast RAM, and if you contact the manufacturer, they
  119.         recommend more.
  120.  
  121.     use the simpler:
  122.  
  123.         2 MB RAM required.  More is recommended by the manufacturer.
  124.  
  125.     I recommend putting the required item FIRST in the sentence.>>
  126.  
  127.     HARDWARE
  128.  
  129.         <<If there are no special hardware requirements, write
  130.         NONE.>>
  131.  
  132.         <<How much RAM is needed?>>
  133.     
  134.         <<Does it require a hard drive?  If so, how much space is
  135.         needed?>>
  136.  
  137.         <<Does it work with a CPU faster than a 68000?>>
  138.  
  139.         <<Does it REQUIRE a CPU faster than a 68000?
  140.         Is a faster processor recommended by the manufacturer?>>
  141.  
  142.     SOFTWARE
  143.     
  144.         <<If there are no special software requirements, write
  145.         NONE.>>
  146.  
  147.         <<What minimum version of the operating system is required?>>
  148.  
  149.         <<Does it work correctly under the latest version of the
  150.         operating system?  If not, what is wrong?>>
  151.  
  152.  
  153. COPY PROTECTION
  154.  
  155.     <<A description of the copy protection mechanism.  Please use
  156.     the terms:
  157.  
  158.     None
  159.  
  160.     Disk-based (the disk itself cannot be copied with DiskCopy)
  161.  
  162.     Key disk (the disk can be copied with DiskCopy, but the
  163.      original disk must be inserted to let the program run)
  164.  
  165.     Look up a word in the manual
  166.  
  167.     Dongle (hardware device attached to an Amiga port)
  168.  
  169.     Other (what kind?) >>
  170.  
  171.  
  172.     <<Does the program install on a hard drive?>>
  173.  
  174.     <<Does it require you to boot on the original disk?>>
  175.  
  176.     <<Does it save data onto the copy protected disk?  (Some games will
  177.     save their high score tables, etc., directly onto the copy protected
  178.     disk.  Some people think this bad.)>>
  179.  
  180.     <<In addition, please rate the copy protection mechanism according
  181.     to the following scale:
  182.  
  183.         Invisible    You don't notice it at all
  184.         Acceptable    You notice it, but it is not too bad
  185.         Annoying    Very noticable and annoying
  186.         Terrible    Harmful to your disk drive hardware,
  187.                 extremely inconvenient, etc.>>
  188.  
  189. MACHINE USED FOR TESTING
  190.  
  191.     <<What model(s) of Amiga did you use while testing the product?>>
  192.     <<How much Chip RAM and Fast RAM?>>
  193.     <<What versions of Kickstart and Workbench?>>
  194.     <<Any other special, relevant hardware and software?>>
  195.  
  196.     <<I suggest that you list your machine's features, one per line,
  197.     rather than in paragraph form, unless you have something special
  198.     to explain.  Here is an example:
  199.  
  200.     Amiga 3000/25, 4 MB Fast RAM, 2 MB Chip RAM.
  201.     2 internal 880K floppies.
  202.     Maxtor 550 MB internal hard drive.
  203.     Archive Viper 250 MB tape drive (external).
  204.     NEC 3D multisync monitor.
  205.     AmigaDOS 2.1.
  206.     WShell 2.0 replacing the Amiga shell.
  207.  
  208.     >>
  209.  
  210.     <<NOTE!!  If you are using an unreleased version of Kickstart or
  211.     Workbench, you must be a registered developer and say so in your
  212.     review, or else I may reject the review.  My reason is that
  213.     unreleased Kickstart/Workbench versions have bugs and quirks that
  214.     the release versions do not.  Therefore, any bugs that you report in
  215.     your product review might be caused by Kickstart/Workbench bugs, and
  216.     your review may be misleading.>>
  217.     
  218.  
  219. INSTALLATION
  220.  
  221.     <<How is the product installed on an Amiga (if at all)?>>
  222.     <<How easy or hard is the process?>>
  223.     <<If software, does it use the Commodore Installer program?>>
  224.  
  225.  
  226. REVIEW
  227.  
  228.     <<Your review goes here!>>
  229.     <<This is the longest part of the article.>>
  230.  
  231.     <<If your review is very long, you might want to break it into
  232.     several parts, each with its own heading.  In this case, forget the
  233.     "REVIEW" heading, and make your new headings just like all the
  234.     others -- in CAPITAL LETTERS and at the left margin.>>
  235.  
  236.  
  237. DOCUMENTATION
  238.  
  239.     <<Does it come with documentation?  Printed, or on disk?>>
  240.  
  241.     <<How is the quality of the documentation?  Does it tell you
  242.     everything you NEED to know?  Everything you WANT to know?>>
  243.  
  244.     <<Is the documentation written for beginners?  Experts?>>
  245.  
  246.  
  247. LIKES
  248.  
  249.     <<What about the product do you like?  Why?>>
  250.  
  251.  
  252. DISLIKES AND SUGGESTIONS
  253.  
  254.     <<What about the product do you dislike?  Why?>>
  255.     <<Do you have any suggestions to improve the product?>>
  256.  
  257.  
  258. COMPARISON TO OTHER SIMILAR PRODUCTS
  259.  
  260.     <<Have you used other products that are similar to this one?
  261.     If so, how would you compare them?>>
  262.  
  263.     <<NOTE:  your review should be mostly independent of other products.
  264.     Don't just say "it works like WordMaster" because the reader might
  265.     not know what WordMaster is.>>
  266.  
  267.  
  268. BUGS
  269.  
  270.     <<Did you find any bugs?  What were they?  Did you discuss them with
  271.     the author/company?  Are patches or workarounds available?>>
  272.  
  273.  
  274. VENDOR SUPPORT
  275.  
  276.     <<If you have contacted the vendor for support, please describe your
  277.     experiences.>>
  278.  
  279.     <<If you are associated with the vendor IN ANY WAY except as a
  280.     customer, please describe your association.>>
  281.  
  282.  
  283. WARRANTY
  284.  
  285.     <<How long does the product warranty last, if there is a warranty,
  286.     and what is covered?>>
  287.  
  288.     <<Does the warranty apply only to the original purchaser?>>
  289.  
  290.     <<Do not make any guesses in this section, like:  "I am sure that
  291.     the manufacturer would cover blah blah blah...."  Report only the
  292.     facts.>>
  293.  
  294.  
  295. CONCLUSIONS
  296.  
  297.     <<Is the product good?