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