home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #31 / NN_1992_31.iso / spool / comp / sources / reviewed / 141 next >
Encoding:
Text File  |  1992-12-31  |  6.8 KB  |  191 lines

  1. Newsgroups: comp.sources.reviewed
  2. Path: sparky!uunet!zaphod.mps.ohio-state.edu!pacific.mps.ohio-state.edu!linac!att!news.cs.indiana.edu!noose.ecn.purdue.edu!mentor.cc.purdue.edu!feserve.cc.purdue.edu!csr
  3. From: Kevin Braunsdorf <csr-request@cc.purdue.edu>
  4. Subject: Introduction & Guidelines for CSR
  5. Message-ID: <C04xp6.DpD@mentor.cc.purdue.edu>
  6. Followup-To: poster
  7. Originator: csr@feserve.cc.purdue.edu
  8. Keywords: new year, new moderator, new style, mail-server
  9. Sender: news@mentor.cc.purdue.edu (USENET News)
  10. Organization: PUCC UNIX Group
  11. Date: Thu, 31 Dec 1992 17:53:30 GMT
  12. Approved: csr@cc.purdue.edu
  13. Lines: 176
  14.  
  15.  
  16. This posting provides an introduction to the newsgroup "comp.sources.reviewed"
  17. (CSR).  It contains a description of the group, information about the CSR
  18. archives, and some guidelines for getting started as a submitter/reviewer.
  19.  
  20. Other information that is available includes the "Guidelines for
  21. Reviewers" document that we use in evaluating submissions, and an Index
  22. of sources already posted to the group.  This information is posted
  23. occasionally to CSR, or it can be obtained via anonymous FTP from
  24. ftp.uu.net:/usenet/comp.sources.reviewed.  Failing that, you can ask me
  25. for the information.
  26.  
  27. People wanting to submit sources, become a reviewer, or get more
  28. information should send mail:
  29.  
  30.     To: csr@cc.purdue.edu
  31.     Subject: send guide
  32.  
  33.     Thanks,
  34.     <your sig here>
  35.  
  36.  
  37. What is Comp.Sources.Reviewed?
  38. ------------------------------
  39.  
  40. "Comp.sources.reviewed" is a moderated newsgroup (moderator: Kevin
  41. Braunsdorf [csr-request@cc.purdue.edu]) with the following charter:
  42.  
  43.     Comp.sources.reviewed is a moderated newsgroup for the distribution of
  44.     program sources that have been subjected to a Peer Review process.
  45.     Similar to the process used for academic journals, submissions are sent
  46.     to a moderator who then sends the sources to Peer Review volunteers for
  47.     evaluation.  The Reviewers are asked to provided a timely evaluation of
  48.     the software by compiling and running it on their machine.  If time does
  49.     not permit them to complete a review, they are responsible for asking
  50.     the moderator to select another reviewer.  If the Moderator and Peer
  51.     Reviewers judge a submission to be acceptable, the sources will be
  52.     posted along with the written comments provided by the Reviewers.  If a
  53.     submission is not found to be acceptable, the author will be provided
  54.     with the Reviewers' comments, and they will have the option of
  55.     addressing those comments and submitting the sources again.
  56.  
  57.  
  58.  
  59. What are the steps of the peer review process?
  60. ----------------------------------------------
  61.  
  62. A typical sequence of events for the review of sources is:
  63.  
  64. - software is mailed to a mail-server in small (59k) shar files
  65. - mail-server acknowledges receipt and wakes up moderator
  66. - moderator briefly checks software against guidelines listed above
  67. - moderator builds a Call For Reviews (CFR) and a part-0
  68. - moderator posts CFR to comp.sources.testers
  69.   (or if it is a patch sends mail to previous reviewers)
  70. - reviewers volunteer for package and receive it from the mail-server
  71. - reviewers unpack and gloss over the source
  72. - reviewers might `nix' the package based on some obvious botch here
  73. - reviewers build, install, run, and test the software
  74. - reviewers return evaluations to mail-server
  75.   (based on guidelines described an another document)
  76. - moderator compiles evaluations and makes final publication decision
  77. - if submission is accepted:
  78.     - moderator discusses evaluations with author
  79.     - moderator posts sources and evaluations
  80. - if submission is not accepted:
  81.     - moderator sends evaluations to author
  82.     - moderator may suggest revision and resubmission,
  83.       (or posting in another newsgroup)
  84.  
  85.  
  86. What if the reviewers find problems?
  87. ------------------------------------
  88.  
  89. We are discouraging making repairs to submissions during the review process.
  90. Reviewers may contact you for information and clarification, but we do not
  91. envision fixes being applied during the course of a review.
  92.  
  93. Once the reviews are completed, you will receive a summary from the moderator,
  94. and, if necessary, will have a chance to make repairs to your package.
  95.  
  96.  
  97. Where are the Archives?
  98. -----------------------
  99.  
  100. The official archive site for comp.sources.reviewed is ftp.uu.net
  101. (uunet.uu.net), and the sources are available by anonymous FTP (and
  102. other means) in /usenet/comp.sources.reviewed.  Like most sources
  103. groups, the archives for CSR are organized in terms of "volumes".
  104.  
  105. We have also been told that:
  106.  
  107.     The USENET archive section of the Anonymous FTP area of kirk [in
  108.     Australia] now holds an archive of comp.sources.reviewed.  This
  109.     archive is updated daily (i.e.  any posting will can be found in the
  110.     archive and associated indexes within 24 hours of the news article
  111.     being received by kirk).
  112.  
  113.     The archive is available via anonymous FTP only on kirk.bu.oz.au:
  114.     (131.244.1.1).  Fetchfile access will be available in the near
  115.     future.
  116.  
  117.     For more information, please contact ftp@kirk.bu.oz.au.
  118.  
  119. An alternative archive site in the USA is:
  120.  
  121. Site:         sparky.sterling.com (sparky)
  122. Contact:      Kent Landfield (kent@sparky.sterling.com) (402) 291-8300
  123. Location:     Omaha/Bellevue, NE
  124. Modems:       Telebit
  125. UUCP:         On request
  126. FTP:          Anonymous FTP
  127. Mail server:  NA (Yet)    
  128. Additional:   This archive site uses Volume-Issue archiving.
  129.  
  130.  
  131. How do I use that silly mail-server?
  132. ------------------------------------
  133.  
  134. Send a mail message to it like:
  135.     To: csr@cc.purdue.edu
  136.     Subject: help
  137.  
  138.     Thanks!
  139.     <your sig here>
  140.  
  141. And it will send you a help file.  Here is a summary of the Subject lines
  142. the mail-server might do something useful with:
  143. Info commands:
  144.     Subject: help
  145.     Subject: index
  146.     Subject: send index
  147.     Subject: send guide
  148.  
  149. To get source:
  150.     Subject: send product
  151.  
  152. To ACK or NAK and product:
  153.     Subject: got product
  154.     Subject: nix product
  155.  
  156. To (back out of a) review:
  157.     Subject: review product
  158.     Subject: drop product
  159.  
  160. To submit a product:
  161.     Subject: submit product-version part/total
  162.  
  163.  
  164. What can I review right now?
  165. ----------------------------
  166.  
  167. This is the comp.sources.reviewed index.
  168.  
  169. Name                   Parts   Size   Description
  170. by-1.2                   1      58k   group lines
  171. dbuf-1                   1      14k   double buffer routines
  172. deliver-2.1-patch-11     2      11k   patch #11 to Deliver 2.1
  173. guide-2                  4      50k   guides for reviewers and submitters
  174. index-1                  2       5k   this index
  175. rcinfo-1.1               6     208k   (hesiod style) network database
  176. test-0                   1       5k   the test submission for play
  177.  
  178.  
  179. What else should I do?
  180. ----------------------
  181.  
  182. Subscribe to comp.sources.testers -- we need you.
  183.  
  184. Thanks for you time and efforts!
  185. --
  186. Kevin Braunsdorf, csr-request@cc.purdue.edu
  187. -- 
  188.         Andrew Patrick acting as Comp.Sources.Reviewed Moderator
  189.               Department of Communications, Ottawa, CANADA
  190.                          csr@calvin.dgbt.doc.CA
  191.