home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / reviews / doc / template < prev    next >
Text File  |  1995-06-16  |  9KB  |  312 lines
  1.             COMP.SYS.AMIGA.REVIEWS
  2.                        Template For Full Reviews
  3.               (Optional but recommended)
  4.                      Last modified  June 16, 1995
  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.     <<LEAVE ALL HEADINGS ("Name:" etc.) in place - do not delete them.
  58.     Also, please do not change the spacing and tabbing here.>>
  59.  
  60.     Name:        ...
  61.     Address:    ...
  62.  
  63.     Telephone:    ...
  64.     FAX:        ...
  65.  
  66.     E-mail:        ...
  67.     World Wide Web:    ...
  68.  
  69.     <<If the telephone number is an "800" toll-free number, and you
  70.       live in the USA or Canada, please call it and ask for a
  71.       non-800 number for our international friends to use.>>
  72.  
  73.  
  74. LIST PRICE
  75.  
  76.     <<The list price of the product.  Remember to say what currency
  77.     units you are using (US dollars, Canadian dollars, francs, ...).>>
  78.  
  79.     <<Optionally, you may also include the price you paid,
  80.     but do not advertise for any particular store!>>
  81.  
  82.  
  83. SPECIAL HARDWARE AND SOFTWARE REQUIREMENTS
  84.  
  85.     <<Does your Amiga require any special hardware or software before
  86.     you can use the product?>>
  87.  
  88.     <<Keep your comments brief so they are easy for the reader to scan
  89.     quickly.  (But go into detail if it is necessary!  Don't sacrifice
  90.     accuracy.)  For example, instead of writing:
  91.  
  92.         The Whizbang Amiga Gadget requires at least 2 megabytes of
  93.         Fast RAM, and if you contact the manufacturer, they
  94.         recommend more.
  95.  
  96.     use the simpler:
  97.  
  98.         2 MB RAM required.  More is recommended by the manufacturer.
  99.  
  100.     I recommend putting the required item FIRST in the sentence.>>
  101.  
  102.     HARDWARE
  103.  
  104.         <<If there are no special hardware requirements, write
  105.         NONE.>>
  106.  
  107.         <<How much RAM is needed?>>
  108.     
  109.         <<Does it require a hard drive?  If so, how much space is
  110.         needed?>>
  111.  
  112.         <<Does it work with a CPU faster than a 68000?>>
  113.  
  114.         <<Does it REQUIRE a CPU faster than a 68000?
  115.         Is a faster processor recommended by the manufacturer?>>
  116.  
  117.     SOFTWARE
  118.     
  119.         <<If there are no special software requirements, write
  120.         NONE.>>
  121.  
  122.         <<What minimum version of the operating system is required?
  123.         Please use the word "AmigaDOS" to refer to the operating
  124.         system -- not "Amiga OS", not "KS/WB", etc.>>
  125.  
  126.         <<Does it work correctly under the latest version of the
  127.         operating system?  If not, what is wrong?>>
  128.  
  129.  
  130. COPY PROTECTION
  131.  
  132.     <<A description of the copy protection mechanism.  Please use
  133.     the terms:
  134.  
  135.     None
  136.  
  137.     Disk-based (the disk itself cannot be copied with DiskCopy)
  138.  
  139.     Key disk (the disk can be copied with DiskCopy, but the
  140.      original disk must be inserted to let the program run)
  141.  
  142.     Look up a word in the manual
  143.  
  144.     Dongle (hardware device attached to an Amiga port)
  145.  
  146.     Other (what kind?) >>
  147.  
  148.  
  149.     <<Does the program install on a hard drive?>>
  150.  
  151.     <<Does it require you to boot on the original disk?>>
  152.  
  153.     <<Does it save data onto the copy protected disk?  (Some games will
  154.     save their high score tables, etc., directly onto the copy protected
  155.     disk.  Some people think this bad.)>>
  156.  
  157.     <<In addition, please rate the copy protection mechanism according
  158.     to the following scale:
  159.  
  160.         Invisible    You don't notice it at all
  161.         Acceptable    You notice it, but it is not too bad
  162.         Annoying    Very noticable and annoying
  163.         Terrible    Harmful to your disk drive hardware,
  164.                 extremely inconvenient, etc.>>
  165.  
  166. MACHINE USED FOR TESTING
  167.  
  168.     <<What model(s) of Amiga did you use while testing the product?>>
  169.     <<How much Chip RAM and Fast RAM?>>
  170.     <<What versions of Kickstart and Workbench?>>
  171.     <<Any other special, relevant hardware and software?>>
  172.  
  173.     <<I suggest that you list your machine's features, one per line,
  174.     rather than in paragraph form, unless you have something special
  175.     to explain.  Here is an example:
  176.  
  177.     Amiga 3000/25, 4 MB Fast RAM, 2 MB Chip RAM.
  178.     2 internal 880K floppies.
  179.     Maxtor 550 MB internal hard drive.
  180.     Archive Viper 250 MB tape drive (external).
  181.     NEC 3D multisync monitor.
  182.     AmigaDOS 2.1.
  183.     WShell 2.0 replacing the Amiga shell.
  184.  
  185.     >>
  186.  
  187.     <<NOTE!!  If you are using an unreleased version of Kickstart or
  188.     Workbench, you must be a registered developer and say so in your
  189.     review, or else I may reject the review.  My reason is that
  190.     unreleased Kickstart/Workbench versions have bugs and quirks that
  191.     the release versions do not.  Therefore, any bugs that you report in
  192.     your product review might be caused by Kickstart/Workbench bugs, and
  193.     your review may be misleading.>>
  194.     
  195.  
  196. INSTALLATION
  197.  
  198.     <<How is the product installed on an Amiga (if at all)?>>
  199.     <<How easy or hard is the process?>>
  200.     <<If software, does it use the Commodore Installer program?>>
  201.  
  202.  
  203. REVIEW
  204.  
  205.     <<Your review goes here!>>
  206.     <<This is the longest part of the article.>>
  207.  
  208.     <<If your review is very long, you might want to break it into
  209.     several parts, each with its own heading.  In this case, forget the
  210.     "REVIEW" heading, and make your new headings just like all the
  211.     others -- in CAPITAL LETTERS and at the left margin.>>
  212.  
  213.  
  214. DOCUMENTATION
  215.  
  216.     <<Does it come with documentation?  Printed, or on disk?>>
  217.  
  218.     <<How is the quality of the documentation?  Does it tell you
  219.     everything you NEED to know?  Everything you WANT to know?>>
  220.  
  221.     <<Is the documentation written for beginners?  Experts?>>
  222.  
  223.  
  224. LIKES
  225.  
  226.     <<What about the product do you like?  Why?>>
  227.  
  228.  
  229. DISLIKES AND SUGGESTIONS
  230.  
  231.     <<What about the product do you dislike?  Why?>>
  232.     <<Do you have any suggestions to improve the product?>>
  233.  
  234.  
  235. COMPARISON TO OTHER SIMILAR PRODUCTS
  236.  
  237.     <<Have you used other products that are similar to this one?
  238.     If so, how would you compare them?>>
  239.  
  240.     <<NOTE:  your review should be mostly independent of other products.
  241.     Don't just say "it works like WordMaster" because the reader might
  242.     not know what WordMaster is.>>
  243.  
  244.  
  245. BUGS
  246.  
  247.     <<Did you find any bugs?  What were they?  Did you discuss them with
  248.     the author/company?  Are patches or workarounds available?>>
  249.  
  250.  
  251. VENDOR SUPPORT
  252.  
  253.     <<If you have contacted the vendor for support, please describe your
  254.     experiences.>>
  255.  
  256.     <<If you are associated with the vendor IN ANY WAY except as a
  257.     customer, please describe your association.>>
  258.  
  259.  
  260. WARRANTY
  261.  
  262.     <<How long does the product warranty last, if there is a warranty,
  263.     and what is covered?>>
  264.  
  265.     <<Does the warranty apply only to the original purchaser?>>
  266.  
  267.     <<Do not make any guesses in this section, like:  "I am sure that
  268.     the manufacturer would cover blah blah blah...."  Report only the
  269.     facts.>>
  270.  
  271.  
  272. CONCLUSIONS
  273.  
  274.     <<Is the product good?  Bad?  Fair?>>
  275.  
  276.     <<Maybe you want to give the product a rating, like "3 stars out
  277.     of 5.">>
  278.  
  279.     <<What are your final impressions?>>
  280.  
  281.  
  282. COPYRIGHT NOTICE
  283.  
  284.     <<You are welcome, but not required, to label your review as
  285.     copyrighted, freely distributable, or public domain.  If you
  286.     copyright it, use the exact phrase:
  287.  
  288.         Copyright 199_ <<your name here>>.
  289.  
  290.     <<You do not need to write "All rights reserved" any more.>>
  291.  
  292.     <<Remember... by submitting a review, you are AUTOMATICALLY giving
  293.     permission for your review to be posted on USENET, archived on
  294.     our ftp site, and distributed in several other ways.  See the
  295.     monthly posting "Introduction to comp.sys.amiga.reviews" for
  296.     the exact details.>>
  297.  
  298.     <<Please make sure to include your FULL NAME here, so you get
  299.     proper credit as the author of the review.>>
  300.  
  301. ------------8<----------------- cut here ----------------8<------------------
  302.  
  303.     Good luck!!
  304.  
  305. ---
  306.  
  307.    Dan Barrett, Moderator, comp.sys.amiga.reviews
  308.    Send reviews to:    amiga-reviews-submissions@math.uh.edu
  309.    Request information:    amiga-reviews-requests@math.uh.edu
  310.    Moderator mail:    amiga-reviews@math.uh.edu
  311.    Anonymous ftp site:  math.uh.edu, in /pub/Amiga/comp.sys.amiga.reviews
  312.