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