home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk1.iso / answers / news-answers / guidelines next >
Internet Message Format  |  1994-09-19  |  43KB

  1. Path: bloom-beacon.mit.edu!senator-bedfellow.mit.edu!senator-bedfellow.mit.edu!news-answers-request
  2. From: news-answers-request@MIT.EDU (the *.answers moderation team)
  3. Newsgroups: news.answers,alt.answers,comp.answers,de.answers,misc.answers,rec.answers,sci.answers,soc.answers,talk.answers
  4. Subject: *.answers submission guidelines
  5. Supersedes: <news-answers/guidelines_776427477@rtfm.mit.edu>
  6. Followup-To: poster
  7. Date: 19 Sep 1994 09:40:18 GMT
  8. Organization: Massachvsetts Institvte of Technology
  9. Lines: 916
  10. Approved: news-answers-request@MIT.EDU
  11. Distribution: world
  12. Expires: 2 Nov 1994 09:39:49 GMT
  13. Message-ID: <news-answers/guidelines_779967589@rtfm.mit.edu>
  14. Reply-To: news-answers-request@MIT.EDU (the *.answers moderation team)
  15. NNTP-Posting-Host: bloom-picayune.mit.edu
  16. Originator: jik@bloom-picayune.MIT.EDU
  17. Xref: bloom-beacon.mit.edu news.answers:25949 alt.answers:4523 comp.answers:7340 de.answers:155 misc.answers:892 rec.answers:7411 sci.answers:1583 soc.answers:1706 talk.answers:353
  18.  
  19. Archive-name: news-answers/guidelines
  20. Version: $Id: guidelines,v 1.123 1994/09/07 21:33:00 pshuang Exp $
  21. Posting-Frequency: monthly
  22.  
  23.  
  24. In order to submit an FAQ posting to the news.answers newsgroup (and
  25. to zero or more of the other *.answers newsgroups (alt.answers,
  26. comp.answers, de.answers, misc.answers, rec.answers, sci.answers,
  27. soc.answers, talk.answers) along with it), you should first modify the
  28. header of your posting to conform to the guidelines given below, in 
  29. section I.  Then, you should submit your posting to us using the 
  30. instructions given below, in section II.
  31.  
  32. Once your posting is approved, you will post it directly to
  33. news.answers and other *.answers newsgroups yourself; i.e., after
  34. approval, you no longer have to go through us at all to post.  This is
  35. explained in more detail below.
  36.  
  37. TABLE OF CONTENTS
  38.  
  39. I. Submission guidelines
  40.  A. Why the guidelines?
  41.   1. Appropriateness
  42.   2. Usefulness to people
  43.   3. Automatic archiving
  44.  B. What the guidelines DON'T specify
  45.  C. Required header fields
  46.   1. The normal header
  47.    a. Newsgroups (Required)
  48.    b. Subject (Required)
  49.    c. Followup-To (Required) and Reply-To (Optional)
  50.    d. Supersedes, Expires, References (Optional)
  51.    e. Summary (Optional)
  52.   2. The auxiliary header
  53.    a. Archive-name (Required)
  54.    b. Other archive names (Optional)
  55.    c. Posting-Frequency (Optional)
  56.    d. Last-modified, Version (Optional)
  57.   3. Sample FAQ headers
  58.  D. Posting frequency
  59.  E. Mailing lists for FAQ maintainers
  60.  F. List of Periodic Informational Postings
  61.  G. Article approval
  62.  H. Checklist
  63. II. Submission instructions
  64. III. Once your posting is approved
  65.    A. Transfer an FAQ to a new maintainer
  66.    B. Change an FAQ's posting frequency
  67.    C. Change an FAQ's header(s)
  68.       1. Subject line
  69.       2. Newsgroups line
  70.       3. From line, without changing maintainers
  71.       4. Archive-name line
  72.       5. Followup-To line
  73.       6. Other headers
  74.    D. Add postings to or delete postings from an FAQ
  75.       1. Split up a single-part FAQ
  76.       2. Add a new part to a FAQ which already has multiple parts
  77.       3. Delete a part from a multi-part FAQ
  78.       4. Add a diff posting
  79.       5. Terminate an FAQ (i.e., stop posting it forever)
  80.    E. Create a new FAQ
  81. IV. This posting
  82. V. Getting the "List of Periodic Informational Postings"
  83.  
  84. ======================================================================
  85.  
  86.  
  87. I. Submission guidelines
  88.  
  89.  A. Why the guidelines?
  90.  
  91.     There are three main reasons for the guidelines:
  92.  
  93.   1. Appropriateness
  94.  
  95.      Only periodic informational postings that are intended to be read
  96.      by people belong in *.answers.  The guidelines are meant to
  97.      prevent other types of postings, including discussion of periodic
  98.      informational postings, from appearing in the group.
  99.  
  100.   2. Usefulness to people
  101.  
  102.      The newsgroup should be as useful as possible to the people who
  103.      read it.  Requirements such as effective "Subject:" and
  104.      "Summary:" lines (see below) further this goal.
  105.  
  106.   3. Automatic archiving
  107.  
  108.      One of the main points for having *.answers newsgroups is that
  109.      they can be archived automatically in order to build up a
  110.      database of periodic informational postings.  Requirements such
  111.      as the "Archive-name:" line further that goal.
  112.  
  113.  B. What the guidelines DON'T specify
  114.  
  115.     These guidelines DO NOT specify a specific, required format for
  116.     the bodies of FAQ postings.  Postings in *.answers are not
  117.     required to adhere to "Digest Message Format" format (Internet RFC
  118.     1153), or MIME (RFC 1341), or HTML, or SGML, or any other text
  119.     format, standard or otherwise.
  120.  
  121.     This omission is intentional.  Forcing all *.answers postings to
  122.     adhere to a specific format would dissuade many FAQ maintainers
  123.     from submitting their postings to *.answers.  Such a result would
  124.     be in direct contradiction to the chartered purpose of *.answers;
  125.     therefore, FAQ maintainers are free to choose whatever format they
  126.     want (assuming that it is human-readable) for the bodies of their
  127.     postings.
  128.  
  129.     These guidelines also DO NOT specify lower or upper limits for the
  130.     size of an acceptable FAQ posting.  However, a pragmatic lower limit
  131.     is set by the requirement that the articles be useful to people.  As
  132.     for a pragmatic upper limit, FAQ maintainers may wish to consider
  133.     that some part of their audience may not be able to access very
  134.     large articles at their sites due to intermediary software problems
  135.     (64KB is a common magic number), so postings larger than that may
  136.     not be able to be read by many people.
  137.  
  138.  C. Required header fields
  139.  
  140.     There are two "headers" in a *.answers posting.  The first is
  141.     the normal header that any article posted to the USENET has.  The
  142.     second header, the "auxiliary header," is separated from the first
  143.     by one or more blank lines.  As far as the News software is
  144.     concerned, the auxiliary header is just part of the body of the
  145.     article; however, *.answers requires some information in it.
  146.  
  147.     The requirements for each of the two headers are discussed in
  148.     detail below.  Required headers are marked with "(Required)",
  149.     while optional ones are marked with "(Optional)".
  150.  
  151.     You may wish to refer to section 3 for a full set of sample
  152.     headers while reading the detailed descriptions and explanations
  153.     of the required and optional headers.  The headers at the very top
  154.     of this document can also serve as a sample.
  155.  
  156.   1. The normal header
  157.  
  158.    a. Newsgroups (Required)
  159.  
  160.       We need to know exactly what will appear in the Newsgroups line
  161.       of the posting.
  162.  
  163.       In addition to news.answers, your posting should be cross-posted
  164.       to the other *.answers newsgroups of hierarchies in which it is
  165.       posted.  For example, a posting that is normally posted in both
  166.       rec.music.makers.synth and comp.sys.ibm.pc.soundcard should be
  167.       posted to both rec.answers and comp.answers in addition to
  168.       news.answers.  Note that postings to any of the *.answers
  169.       newsgroups MUST be posted in news.answers, regardless of what
  170.       other *.answers newsgroups they also appear in.
  171.  
  172.       There is one exception to the above rule of always crossposting
  173.       to the corresponding *.answers groups: postings to newsgroups
  174.       which go to a non-international hierarchy in a different
  175.       language.  Such an article should not go into the corresponding
  176.       *.answers group.  At present, the only such case is de.answers,
  177.       which is for German-language periodic informational postings
  178.       only.  For example, an English-language FAQ may be posted to a
  179.       de.* group if the maintainer feels it is useful there, but
  180.       should not be not cross-posted to de.answers.
  181.  
  182.       Although the order of newsgroups on the line is not important
  183.       from the point of view of the news software, we prefer to have
  184.       news.answers listed last.  The other *.answers newsgroups should
  185.       be listed directly before news.answers.  Listing the primary
  186.       newsgroup(s) first improves the accuracy of newsgroup volume
  187.       statistics, provides better key information for index lists and
  188.       catalogues, and minimizes accidental postings to the *.answers
  189.       newsgroups from buggy newsreaders.
  190.  
  191.       Example:
  192.  
  193.        Newsgroups: comp.sys.foo,comp.answers,news.answers
  194.  
  195.       Note that your Newsgroups line should NOT contain only *.answers
  196.       groups.  FAQ postings should be cross-posted to *.answers from
  197.       their home newsgroups, rather than being posted separately to
  198.       *.answers.
  199.  
  200.       However, if you get approval for *.answers cross-posting in the
  201.       middle of your "posting cycle," and you do not wish to wait
  202.       until the next scheduled posting time to cross-post to
  203.       *.answers, then you can post your FAQ only to *.answers.  If you
  204.       choose to do this, please make sure to let us know you are going
  205.       to, and please do not do it more than once.
  206.  
  207.    b. Subject (Required)
  208.  
  209.       The subject line of your posting should have some meaning
  210.       outside of its home newsgroup(s).  For example, instead of just
  211.       "FAQ," you might have "<x> FAQ", where "<x>" is the name of the
  212.       newsgroup or the topic being discussed.
  213.  
  214.       Furthermore, important information should appear near the
  215.       beginning of the subject line, so that news readers that display
  216.       article summaries don't cut off the important information.  For
  217.       example, instead of "Frequently Asked Questions about <x>," use
  218.       "<x> Frequently asked Questions."
  219.  
  220.       Please note that most archivers treat the subject as 
  221.       case-sensitive -- it must always be capitalized in exactly the 
  222.       same way.
  223.  
  224.       For postings which are being split into multiple parts, you
  225.       should indicate in each posting's Subject line which part that
  226.       particular posting is, and how many parts total there are.  For
  227.       this purpose, simple Arabic numerals are prefered over Roman
  228.       numerals because Arabic numerals are more easily sorted and
  229.       manipulated by software. (See section III.D for more information
  230.       on splitting existing FAQs.)
  231.  
  232.       Example:
  233.  
  234.        Subject: comp.sys.foo Frequently Asked Questions (FAQ), Part 1/2
  235.        Subject: comp.sys.foo Frequently Asked Questions (FAQ), Part 2/2
  236.  
  237.    c. Followup-To (Required) and Reply-To (Optional)
  238.  
  239.       Your posting must have a "Followup-To:" line in the header that
  240.       directs followups to somewhere other than *.answers.  You may
  241.       choose to direct followups back to the home newsgroup(s) of the
  242.       FAQ, or to direct followups to the author of the FAQ, in which
  243.       case "Followup-To: poster" is sufficient.  That means that you
  244.       actually put the word "poster" there, as specified in the RFC
  245.       which describes the format of Usenet postings.  Do NOT put an
  246.       E-mail address in the "Followup-To:" field.
  247.  
  248.       If you forget the "Followup-To:" and we get mailed followups to
  249.       your FAQ, we're going to get peeved at you.
  250.  
  251.       Furthermore, your posting must have a valid E-mail reply address
  252.       in the header, either in the "From:" field, or if not in "From:"
  253.       then in "Reply-To:".
  254.  
  255.       Example:
  256.  
  257.        From: guru@foosys.com (Joe R. Programmer)
  258.        Followup-To: comp.sys.foo
  259.        Reply-To: faq-mail@foosys.com (FAQ Comments address)
  260.  
  261.       In this example, "guru" apparently wants mail about the FAQ to
  262.       go to a different address than the rest of his mail.  We've
  263.       shown the "From:" header, because the version of the FAQ that
  264.       you forward to us should show the "From:" header just as it will
  265.       appear when the article is actually posted.
  266.  
  267.    d. Supersedes, Expires, References (Optional)
  268.  
  269.       It is a good idea to use "Supersedes:" and "Expires:" header
  270.       lines to make sure that each version of your FAQ stays around
  271.       until the next time it is posted.  A useful tool for this is the
  272.       Perl FAQ poster written by Jonathan Kamens.  It is available
  273.       from rtfm.mit.edu, via anonymous ftp in the file
  274.       /pub/post_faq/post_faq.shar, or via mail server (send mail to
  275.       mail-server@rtfm.mit.edu with "send post_faq/post_faq.shar" in
  276.       the body).
  277.  
  278.       Post_faq takes an article with its static headers (i.e., the
  279.       headers that don't change each time the article is posted)
  280.       included, adds dynamic headers to it, and posts the article.
  281.       Another utility, Ian Kluft's auto-faq package (which is also
  282.       written in Perl) provides more functionality, including
  283.       automatic building and insertion of all headers.  If you are
  284.       looking for something with a high level of automation to
  285.       assist you in your FAQ maintenance and posting, you might want
  286.       to try auto-faq instead of post_faq.  The latest version is 3.2
  287.       and is available via anonymous FTP from charon.amdahl.com in
  288.       files:
  289.  
  290.       /pub/faq/auto-faq32.part1.gz
  291.       /pub/faq/auto-faq32.part2.gz
  292.       /pub/faq/auto-faq32.part3.gz
  293.  
  294.       (Note: It's strongly encouraged that you use version 3.x or
  295.       later as previous versions have an identified bug in 
  296.       formatting dates, such as in the Expires header.)  For further
  297.       assistance, send E-mail to auto-faq-help@kluft.com.
  298.  
  299.       Furthermore, if you are posting a multi-part FAQ posting or a
  300.       series of related FAQ postings, it is a good idea to add a
  301.       "References:" line to all of the postings except the first one,
  302.       making the contents of that line the Message-ID of the first
  303.       posting in the series.  If you do this, then people who use
  304.       threaded news readers will be able to manipulate the entire
  305.       series as a single thread, including (for example) killing the
  306.       entire thread if they're not interested or saving the entire
  307.       thread to a file with one command.  The perl FAQ posting tools
  308.       mentioned above support an option for doing this.
  309.  
  310.       Example:
  311.  
  312.        Expires: Fri, 1 May 1992 00:00:00 GMT
  313.        Supersedes: <foo-faq/part2_701650000@foosys.com>
  314.        References: <foo-faq/part1_702000000@foosys.com>
  315.  
  316.       The date in the "Expires:" header should be far enough into the
  317.       future that a new version of the FAQ will be posted before the
  318.       one you're posting now expires.  We've shown all three headers in the
  319.       format the post_faq script would use. 
  320.  
  321.    e. Summary (Optional)
  322.  
  323.       You are encouraged to put a summary of the contents of your
  324.       article in the Summary field of the header.  Try to describe
  325.       what your FAQ discusses, and aim your description at someone who
  326.       may not actually be directly interested in the topic covered by
  327.       your FAQ.  There have been discussions about using the Summary
  328.       fields of the FAQ postings in *.answers to construct a short
  329.       "catalog" of the information available through news.answers, so
  330.       think of the Summary field as a "catalog entry" for your FAQ.
  331.  
  332.       Note that header fields (except for the Newsgroups field) are
  333.       allowed to span multiple lines, as long as the continuation
  334.       lines after the first start with whitespace (at least one space
  335.       or tab character).
  336.  
  337.       Example:
  338.  
  339.        Summary: This posting contains a list of Frequently Asked
  340.                Questions (and their answers) about Foo computers.  It
  341.                should be read by anyone who wishes to post to the
  342.                comp.sys.foo newsgroup.
  343.  
  344.   2. The auxiliary header
  345.  
  346.      The auxiliary header looks like the main message header (i.e.
  347.      "Field-name: field-value"), but is separated from the main
  348.      message header by a blank line, as well as followed by a blank
  349.      line separating it from the rest of the body of the message.
  350.  
  351.      The auxiliary header of this posting is:
  352.  
  353.      Archive-name: news-answers/guidelines
  354.      Version: $Id: guidelines,v 1.123 1994/09/07 21:33:00 pshuang Exp $
  355.      Posting-Frequency: monthly
  356.  
  357.    a. Archive-name (Required)
  358.  
  359.       In order to be cross-posted into *.answers, your posting must
  360.       include an auxiliary header with an "Archive-name:" field.
  361.  
  362.       The purpose of the archive name is two-fold.  First of all, it
  363.       specifies where the FAQ should be stored in archives of the
  364.       *.answers newsgroups.  Second, it should give people, even
  365.       people who do not read the home newsgroup of the FAQ, a pretty
  366.       good idea of what's in it.  Therefore, abbreviations which will
  367.       only be recognized by people already familiar with the topic
  368.       covered by the FAQ should be avoided if possible.
  369.  
  370.       The archive name should be composed of one or more one-word
  371.       (i.e., no spaces) components, separated by slashes.  Each
  372.       component should be 14 characters or less in length, if
  373.       possible, but this is not a strict requirement; if 14 characters
  374.       isn't enough, then each component should be unique in the first
  375.       14 characters (i.e., two archive names should never be identical
  376.       after their components are all truncated to 14 characters).
  377.       Avoid periods in the archive name, because some operating
  378.       systems choke on them; if you must have word separators, use
  379.       hyphens or underscores rather than periods.  Please note that
  380.       most archivers treat the archive name as case-sensitive -- it 
  381.       must always be capitalized in exactly the same way.
  382.  
  383.       The archive namespace is hierarchical; for example, there are a
  384.       number of lists of bookstores in the "books/stores" directory of
  385.       the namespace, and all of their archive names start with
  386.       "books/stores/".  Avoid using slashes in your archive name
  387.       unless you are taking advantage of the hierarchical nature of
  388.       the namespace, i.e., unless you have multiple related FAQ
  389.       postings which should appear in a single directory in the
  390.       archive namespace.
  391.  
  392.       Multi-part FAQs should be named "name/part1", "name/part2", etc.
  393.       Alternatively, if the parts of the FAQ are split by topic rather
  394.       than by size, then you can use short topic names rather than
  395.       "part1", "part2", etc.
  396.  
  397.       If you post a diff for your FAQ, it should be named "name/diff".
  398.       If you post multiple diffs for a multi-part FAQ, they should be
  399.       named "name/diff1", "name/diff2", etc. (if you want to use just
  400.       one diff for a multi-part FAQ, you can just use "name/diff" as
  401.       its name).  If you post a diff to a one-part posting, then the
  402.       original FAQ should be named "name/part1" (or "name/faq", or
  403.       whatever else you think is appropriate, as long as we approve
  404.       it) and the diff should be named "name/diff".
  405.  
  406.       Consider these examples:
  407.  
  408.         Topic                                   Archive name(s)
  409.         -----------------------------------     ------------------------------
  410.         comp.ai FAQ                             ai-faq/part1
  411.                                                 ai-faq/part2
  412.                                                 ai-faq/part3
  413.         rec.travel.air FAQs, various topics     air-travel/bucket-shops
  414.                                                 air-travel/cheap-tickets/part1
  415.                                                 air-travel/cheap-tickets/part2
  416.                                                 air-travel/faq
  417.                                                 air-travel/jetlag-prevention
  418.                                                 air-travel/na-airport-codes
  419.                                                 air-travel/world-airport-codes
  420.         soc.culture.esperanto FAQ               esperanto-faq
  421.  
  422.       Please pick the archive name that you would like to use for your
  423.       posting, and include the "Archive-name:" line with that archive
  424.       name in it, when submitting to *.answers.  If there is some
  425.       problem with it, or if we would like to suggest an alternate
  426.       name, we will let you know.
  427.  
  428.       Example:
  429.  
  430.        Archive-name: foo-faq/part2
  431.  
  432.       If your posting already has an "Archive-name:" line which is not
  433.       a valid *.answers archive name and you do not want to change it,
  434.       or if you want the "Archive-name:" line you add to contain the
  435.       name of a file in your own archives rather than in the
  436.       news.answers archives, you can use a
  437.       "News-answers-archive-name:" header line instead.
  438.  
  439.    b. Other archive names (Optional)
  440.  
  441.       The software which builds the FAQ archive on rtfm.mit.edu (see
  442.       the "Introduction to the *.answers newsgroups" posting for more
  443.       information about it) automatically uses the "Archive-name:"
  444.       line to determine the file name in which to save an FAQ, when
  445.       saving it in any of the "answers" newsgroups (news.answers,
  446.       rec.aviation.answers, etc.).
  447.  
  448.       Furthermore, if you have a field of the form
  449.       "Newsgroup-name-archive-name: name" in your FAQ's auxiliary
  450.       header (see the example below), the specified archive name will
  451.       be used to save in the specified newsgroup.  Such a
  452.       newsgroup-specific archive name overrides any generic
  453.       "Archive-name:" line.
  454.  
  455.       When an archive name for an FAQ cannot be determined in either
  456.       of the ways mentioned above, the Subject line of the posting
  457.       (with some minor modifications) is used as its file name.
  458.  
  459.       For example, if you have this in your normal header:
  460.  
  461.        Newsgroups: comp.foo,comp.bar,comp.answers,news.answers
  462.        Subject: comp.sys.foo Frequently Asked Questions (FAQ), Part 2/2
  463.  
  464.       and this in your auxiliary header:
  465.  
  466.        Archive-name: foo-faq/part2
  467.        Comp-bar-archive-name: bar-faq/part2
  468.  
  469.       then the posting will be saved as "foo-faq/part2" in comp.answers
  470.       and news.answers (because they are both "answers" newsgroups and
  471.       will use the Archive-name line), as "bar-faq/part2" in comp.bar,
  472.       and as "comp.sys.foo_Frequently_Asked_Questions_(FAQ),_Part_2/2"
  473.       in comp.foo.
  474.  
  475.       If you do decide to specify additional archive names in your
  476.       posting, please obey the guidelines for archive names given
  477.       above.
  478.  
  479.    c. Posting-Frequency (Optional)
  480.  
  481.       A "Posting-Frequency" field in the auxiliary header can give
  482.       the reader a good idea of how often your FAQ is posted, for example
  483.       "every 14 days" or "monthly" (see section D, below).
  484.  
  485.       Example:
  486.  
  487.        Posting-Frequency: monthly
  488.  
  489.       If you specify this field, it will be automatically copied into
  490.       the "List of Periodic Informational Postings".
  491.  
  492.    d. Last-modified, Version (Optional)
  493.  
  494.       You can have other fields in the auxiliary header, if you want.
  495.       Two common ones are "Last-modified:" and "Version:". You may put
  496.       any text you want in these fields, in any format you wish.
  497.  
  498.       Example:
  499.  
  500.        Last-modified: 1992/03/25
  501.        Version: 2.5
  502.       
  503.   3. Sample FAQ headers
  504.  
  505.      Putting together the examples we"ve given above, here is what the
  506.      headers of part 2 of your posting (or, at least, the ones you
  507.      submit to us) might look like:
  508.  
  509.      From: guru@foosys.com (Joe R. Programmer)
  510.      Newsgroups: comp.sys.foo,comp.answers,news.answers
  511.      Subject: comp.sys.foo Frequently Asked Questions (FAQ), Part 2/2
  512.      Followup-To: comp.sys.foo
  513.      Reply-To: faq-mail@foosys.com (FAQ Comments address)
  514.      Summary: This posting contains a list of Frequently Asked
  515.              Questions (and their answers) about Foo computers.  It
  516.              should be read by anyone who wishes to post to the
  517.              comp.sys.foo newsgroup.
  518.      Expires: Fri, 1 May 1992 00:00:00 GMT
  519.      Supersedes: <foo-faq/part2_701650000@foosys.com>
  520.      References: <foo-faq/part1_702000000@foosys.com>
  521.  
  522.      Archive-name: foo-faq/part2
  523.      Posting-Frequency: monthly
  524.      Last-modified: 1992/03/25
  525.      Version: 2.5
  526.  
  527.      Note that the blank line separating the normal header from the
  528.      auxiliary header must be completely blank, i.e., no tabs or
  529.      spaces, and that there must also be one or more completely blank
  530.      lines after the auxiliary header.
  531.  
  532.      Of course, you can include in the posting header any of the other
  533.      standard USENET header fields that have not been discussed here.
  534.  
  535.  D. Posting frequency
  536.  
  537.     The frequency at which you choose to post your FAQ is left to your
  538.     discretion.  Some FAQ maintainers find that a monthly posting,
  539.     with an Expires header to prevent each posting from going away
  540.     before its replacement is posted, is sufficient.  Some other
  541.     newsgroups are so busy that a weekly posting of the FAQ is needed.
  542.     Another possibility is to post the complete FAQ relatively
  543.     infrequently, while posting a shorter pointer to it (e.g.,
  544.     providing instructions for getting it from archives) more
  545.     frequently.
  546.  
  547.     If you choose to post your FAQ more frequently than once per
  548.     month, you might want to consider not cross-posting it to
  549.     *.answers every time you post.  Although it may be necessary to
  550.     post the FAQ in its home newsgroup often, it is probably not
  551.     necessary to post it in *.answers as frequently.
  552.  
  553.     Note, however, that if you do this, you can't use Supersedes every
  554.     time you post your FAQ, since a posting in just the FAQ's home
  555.     newsgroup should not supersede the posting in both the home
  556.     newsgroup and *.answers.  Therefore, unless you're willing to have
  557.     two copies of your FAQ in your home newsgroup at all times, you
  558.     should always cross-post to *.answers (or use the system mentioned
  559.     above, cross-posting the full FAQ to *.answers and a more frequent
  560.     pointer posting just in its home newsgroup).
  561.  
  562.     When submitting your FAQ, please be sure to let us know the
  563.     frequency at which you intend to post it to its home newsgroup, as
  564.     well as the frequency at which you intend to cross-post it to
  565.     *.answers (if different).  The best way for this is to put this
  566.     information into the "Posting-Frequency" field of the auxiliary
  567.     header.
  568.  
  569.  E. Mailing lists for FAQ maintainers
  570.  
  571.     Maintainers of FAQs are strongly urged to join the faq-maintainers
  572.     mailing list, which is used for discussion about the *.answers
  573.     newsgroups and the maintenance of USENET FAQs.  Anyone is allowed
  574.     to subscribe to these mailing lists -- in particular, you may
  575.     subscribe before you even submit your FAQ to us.
  576.  
  577.     If you don't want to be on the discussion list, you may wish to
  578.     join the faq-maintainers-announce list, which will be used only
  579.     for announcements, instead.  Note that subscribers to the
  580.     faq-maintainers list automatically receive all messages sent to
  581.     faq-maintainers-announce.
  582.  
  583.     Traffic on faq-maintainers tends to come in bursts -- it averages
  584.     three to four messages per week, but during a burst there may be as
  585.     many as several dozen messages in a single day, and in between such
  586.     bursts, there may be weeks of no messages at all.
  587.  
  588.     Traffic on faq-maintainers-announce is very low (it is not unheard
  589.     of for six months to pass with no messages sent to the list).
  590.  
  591.     When submitting your FAQ, make sure to let us know whether or not
  592.     you want to be on one of the lists, or if you are already
  593.     subscribed. (If you do not, we will ask you if you wish to
  594.     subscribe, so you might as well tell us :). It is best to let us
  595.     know in separate email, rather than including it in the body of
  596.     your FAQ when you first submit it, lest we not notice it in the
  597.     body of your FAQ. All other administrative requests related
  598.     directly to the faq-maintainers or faq-maintainers-announce mailing
  599.     lists should be sent to faq-maintainers-request@mit.edu.
  600.  
  601.  F. List of Periodic Informational Postings
  602.  
  603.     Unless you tell us otherwise, we will add any postings submitted
  604.     to *.answers to the "List of Periodic Informational Postings"
  605.     (LoPIP) articles which appear in news.answers and news.lists.
  606.  
  607.     If you do not have copies of the LoPIP postings and would like to
  608.     get them, to see what they're like or to check if your FAQ is
  609.     already listed, see the instructions at the end of this message.
  610.  
  611.  G. Article approval
  612.  
  613.     Once all of the other issues listed in this posting are resolved,
  614.     you will be given approval to cross-post your FAQ to *.answers.
  615.     You will have to indicate in the header of your posting that such
  616.     approval has been given, or the posting will be mailed to us
  617.     instead of posted.
  618.  
  619.     Note that we are intentionally being somewhat vague about what
  620.     this entails.  When we approve your posting for *.answers, we will
  621.     provide more specific instructions.
  622.  
  623.  H. Checklist
  624.  
  625.     Following is a checklist for your *.answers submission.  Please
  626.     go through all the questions; if you answer "no" to any of
  627.     them, look at the relevant section of this article again, and
  628.     correct your submission accordingly.
  629.  
  630.         Does the posting have a message header?
  631.         Does the posting have a Newsgroups line?
  632.         Does the Newsgroups line contain at least one newsgroup other
  633.                 than the *.answers newsgroups?
  634.         Does the Newsgroups line contain news.answers?
  635.         Are the *.answers newsgroups listed last on the Newsgroups
  636.                 line (with news.answers last of all)?
  637.         Does the Newsgroups line contain all relevant *.answers
  638.                 newsgroups?
  639.         Does the Newsgroups line contain only relevant *.answers
  640.                 newsgroups?
  641.         Does the posting have a Subject line?
  642.         Is the Subject line informative?
  643.         Is important information on the Subject line near the
  644.                 beginning of the line?
  645.         Does the posting have a Followup-To line?
  646.         Does the Followup-To line omit all the *.answers newsgroups?
  647.         Does the posting have a From or Reply-To line with a valid
  648.                 email address?
  649.         Does the posting have an Archive-name line?
  650.         Is the auxiliary header separated from the body of your
  651.                 posting by a blank line?
  652.         Is the auxiliary header separated from the main header by a
  653.                 blank line?
  654.         Is the Archive-name line valid?
  655.         Have you told us the frequency of your posting?
  656.         Have you told us whether you want to be on faq-maintainers or
  657.                 faq-maintainers-announce?
  658.  
  659. II. Submission instructions
  660.  
  661.    If you have a posting which you wish to submit to *.answers, you
  662.    should first read the guidelines listed above and modify your
  663.    posting to conform to them.  Then, you should submit it by posting
  664.    it to the news.answers newsgroup, assuming that the software on the
  665.    poster's site works properly and will forward the posting to the
  666.    news.answers moderator, or by mailing it to the news.answers
  667.    submission address, news-answers@MIT.EDU.  ONLY SUBMISSIONS SHOULD
  668.    BE MAILED TO THAT ADDRESS.  If there is some commentary or
  669.    explanation that needs to be made, it should be mailed in a
  670.    separate message to news-answers-request@MIT.EDU, which is the
  671.    moderator contact address for any *.answers-related business.
  672.  
  673.    If you post the FAQ to both *.answers and one or more other
  674.    moderated groups, you need separate approval from each of the
  675.    moderators.  Wait for approval from each of them (including us)
  676.    before actually posting.  In this case, you should send in the
  677.    FAQ to us via e-mail, because the submission will be sent via
  678.    e-mail to the first moderated group which appears in the
  679.    Newsgroup line.
  680.  
  681.    Please submit the FAQ in a form as close as possible to how it
  682.    appears when you post it normally.  This means that you should
  683.    include a complete header, with at the very least the Subject line
  684.    you normally use.  We very much prefer you actually posting the
  685.    message to *.answers as you would post it normally, including the
  686.    cross-posted newsgroups, but omitting the moderation approval
  687.    header line that would cause the article to actually be posted
  688.    rather than mailed to us; this way, we will get to see exactly how
  689.    the article will look when it is actually posted in *.answers.
  690.    Also, if your FAQ does not say somewhere near the top how often it
  691.    is posted, then please let us know the frequency in separate
  692.    E-mail.
  693.  
  694.    Note that if you do not indicate moderator approval in the header
  695.    of your posting, it will NOT be posted to any newsgroup, even if
  696.    you list other newsgroups on the Newsgroups line besides *.answers
  697.    groups.  Therefore, you CAN and SHOULD place all Newsgroups to
  698.    which you intend to post in the Newsgroups line, in the order you
  699.    intend them to be in when you post.
  700.  
  701.    We will respond, by agreeing that the FAQ belongs in *.answers
  702.    as-is, or by asking you to make minor modifications to it in order
  703.    to make it acceptable, or by rejecting it as inappropriate for
  704.    *.answers.  If you are asked to make modifications, please do so
  705.    and resubmit the posting to us just as you did the first time.
  706.  
  707.    We are all volunteers, doing *.answers moderation in our spare
  708.    time.  Therefore, we can't always process submissions and other
  709.    *.answers-related correspondence immediately.  Please don't
  710.    write to us asking whether we received your submission until at
  711.    least a week after you submitted it.
  712.  
  713.    Once an FAQ has been approved for *.answers, you will post it
  714.    directly to the group yourself, by indicating in the header of the
  715.    message that it was approved by the *.answers moderator, as
  716.    described above.
  717.  
  718.    If possible, try to avoid posting your FAQ at a "predictable"
  719.    time.  For example, if you have decided to post it monthly, don't
  720.    automatically decide to post it on the first of every month.  This
  721.    causes a flood of FAQs in *.answers (and on the net in general) at
  722.    certain times of months, and this flood is big enough to overwhelm
  723.    some smaller sites and many readers of *.answers.  Therefore,
  724.    rather than picking the "obvious" time to post, pick some other,
  725.    random time during the month to do your posting.
  726.  
  727.    If you have trouble posting your FAQ once it has been approved,
  728.    because your site won't let you post to a moderated newsgroup,
  729.    because you don't have good posting access, or because of any other
  730.    reason, feel free to get in touch with us and we'll try to help.
  731.    Alternatively, you can use the FAQ server which we run to help
  732.    solve such problems; you mail your FAQ or FAQs to it, and it posts
  733.    them periodically automatically.  For more information about the
  734.    FAQ server, send mail to faq-server@rtfm.mit.edu with "help"
  735.    (without the quotes) in the Subject of your message.
  736.  
  737.  
  738. III. Once your posting is approved
  739.  
  740.    The following is a list of some situations which might occur after
  741.    your FAQ has been approved for *.answers, and what you need to do
  742.    for each one.
  743.  
  744.    Note that if none of these situations occur, the *.answers
  745.    moderators will expect you to continue posting your FAQ regularly,
  746.    and there is no need to resubmit your FAQ just because you are
  747.    regularly revising its *CONTENTS*.
  748.  
  749.    A. Transfer an FAQ to a new maintainer
  750.  
  751.       The old maintainer should inform news-answers-request@mit.edu of
  752.       the change in maintainers.  The new maintainer should read this
  753.       document (i.e., the "*.answers submission guidelines") and
  754.       inform news-answers-request@mit.edu that he has done so.
  755.       Furthermore, the new maintainer should resubmit the FAQ even if
  756.       there are no header changes planned except for the From and/or
  757.       Reply-To lines, since we'd like to confirm that the new
  758.       maintainer's news server doesn't munge headers.  The new
  759.       maintainer should wait for reapproval before posting.
  760.  
  761.    B. Change an FAQ's posting frequency
  762.  
  763.       Inform news-answers-request@mit.edu of the new frequency, unless
  764.       you have a "Posting-Frequency" field in your auxiliary header;
  765.       in that case, just change that field.  You do not need to await
  766.       reapproval from us.
  767.  
  768.    C. Change an FAQ's header(s)
  769.  
  770.       1. Subject line
  771.  
  772.          Inform news-answers-request@mit.edu of the new Subject line,
  773.          or resubmit the entire FAQ to news-answers@mit.edu; in either
  774.          case, wait for reapproval before posting.
  775.  
  776.       2. Newsgroups line
  777.  
  778.          Inform news-answers-request@mit.edu of the new Newsgroups
  779.          line, or resubmit the entire FAQ to news-answers@mit.edu; in
  780.          either case, wait for reapproval before posting.
  781.  
  782.       3. From line, WITHOUT CHANGING MAINTAINERS
  783.  
  784.          If the new From line obviously refers to the same individual
  785.          as the old one, you don't have to do anything.  If it's not
  786.          obvious that the new From line refers to the same individual,
  787.          inform news-answers-request@mit.edu and wait for reapproval
  788.          before posting.
  789.  
  790.       4. Archive-name line
  791.  
  792.          Inform news-answers-request@mit.edu and wait for reapproval
  793.          before posting.
  794.  
  795.       5. Followup-To line
  796.  
  797.          As long as it exists and doesn't contain any *.answers
  798.          newsgroups in it, you don't have to do anything if you change
  799.          its contents.
  800.  
  801.       6. Other headers
  802.  
  803.          As long as you don't change the overall structure of your
  804.          headers (e.g., make sure you keep an auxiliary header with
  805.          the Archive-name line in it), you don't have to do anything
  806.          about changes to other headers.
  807.  
  808.    D. Add postings to or delete postings from an FAQ
  809.  
  810.       1. Split up a single-part FAQ
  811.  
  812.          Submit all the parts to news-answers@mit.edu, with archive names
  813.          in the format "foo-faq/part1", "foo-faq/part2", etc.  Wait for
  814.          approval before posting.
  815.  
  816.       2. Add a new part to a FAQ which already has multiple parts
  817.  
  818.          Submit the new part to news-answers@mit.edu, or inform
  819.          news-answers-request@mit.edu if the new part's headers are
  820.          consistent with the other parts (e.g., if your Subject lines
  821.          are in the form "foo FAQ part * of *" and your archive names
  822.          look like "foo-faq/part*", and you add a new part which looks
  823.          just like the others except for a new part number, you don't
  824.          have to resubmit the new part or resubmit all the other parts
  825.          because you changed the "of *" number in their Subject
  826.          lines).  Either way, wait for approval before posting with
  827.          the new part or parts.
  828.  
  829.       3. Delete a part from a multi-part FAQ
  830.  
  831.          Inform news-answers-request@mit.edu.  Wait for approval
  832.          before posting.
  833.  
  834.       4. Add a diff posting
  835.  
  836.          Submit it to news-answers@mit.edu.  If you already have a
  837.          multi-part FAQ, choose the archive name to be consistent with
  838.          the other ones. If your archive names look like "foo-faq/part*",
  839.          the diff posting should have the archive name "foo-faq/diff".  If
  840.          your FAQ had only one part before the change, add "/part1" to the
  841.          archive name (e.g. "foo-faq/part1"), and submit both the FAQ and
  842.          the diff posting.  Wait for reapproval before posting the diff.
  843.  
  844.       5. Terminate an FAQ (i.e., stop posting it forever)
  845.  
  846.          Inform news-answers-request@mit.edu.
  847.  
  848.    E. Create a new FAQ
  849.  
  850.       Submit it to *.answers following the guidelines in sections I
  851.       and II above, just like you submitted your previous FAQ(s).
  852.  
  853.  
  854. IV. This posting
  855.  
  856.    Comments about, suggestions about or corrections to this posting
  857.    are welcomed.  If you would like to ask us to change this posting
  858.    in some way, the method we appreciate most is for you to actually
  859.    make the desired modifications to a copy of the posting, and then
  860.    to send us the modified posting, or a context diff between the
  861.    posted version and your modified version (if you do the latter,
  862.    make sure to include in your mail the "Version:" line from the
  863.    posted version).  Submitting changes in this way makes dealing with
  864.    them easier for us and helps to avoid misunderstandings about what
  865.    you are suggesting.
  866.  
  867.    The following people provided feedback and helped to make this
  868.    posting more readable and useful:
  869.  
  870.      Stan Brown <brown@NCoast.ORG>
  871.      L. Detweiler <ld231782@longs.lance.colostate.edu>
  872.      Aydin Edguer <edguer@alpha.CES.CWRU.Edu>
  873.      Mark Eckenwiler <eck@panix.com>
  874.      Tom_Lane@G.GP.CS.CMU.EDU
  875.      Cindy Tittle Moore <tittle@ics.uci.edu> 
  876.      Steven D. Ourada <sourada@iastate.edu>
  877.      Edward Reid <ed@titipu.resun.com>
  878.      Ken Shirriff <shirriff@sprite.Berkeley.EDU>
  879.      Dan Tilque <dant@logos.WR.TEK.COM>
  880.      Bill Wohler <wohler@newt.com>
  881.      Lars Aas <larsa@colargol.edb.tih.no>
  882.  
  883.  
  884. V. Getting the "List of Periodic Informational Postings"
  885.  
  886.    There are eight "List of Periodic Informational Postings"
  887.    postings:
  888.  
  889.     Subject: List of Periodic Informational Postings, Part 1/8
  890.     Subject: List of Periodic Informational Postings, Part 2/8
  891.     Subject: List of Periodic Informational Postings, Part 3/8
  892.     Subject: List of Periodic Informational Postings, Part 4/8
  893.     Subject: List of Periodic Informational Postings, Part 5/8
  894.     Subject: List of Periodic Informational Postings, Part 6/8
  895.     Subject: List of Periodic Informational Postings, Part 7/8
  896.     Subject: List of Periodic Informational Postings, Part 8/8
  897.     Newsgroups: news.lists,news.answers
  898.  
  899.    They are available in the indicated USENET newsgroups, or via
  900.    anonymous ftp from rtfm.mit.edu (18.181.0.24) in the files:
  901.  
  902.     /pub/usenet/news.answers/periodic-postings/part1
  903.     /pub/usenet/news.answers/periodic-postings/part2
  904.     /pub/usenet/news.answers/periodic-postings/part3
  905.     /pub/usenet/news.answers/periodic-postings/part4
  906.     /pub/usenet/news.answers/periodic-postings/part5
  907.     /pub/usenet/news.answers/periodic-postings/part6
  908.     /pub/usenet/news.answers/periodic-postings/part7
  909.     /pub/usenet/news.answers/periodic-postings/part8
  910.  
  911.    They are also available from mail-server@rtfm.mit.edu by sending a
  912.    mail message containing any or all of:
  913.  
  914.     send usenet/news.answers/periodic-postings/part1
  915.     send usenet/news.answers/periodic-postings/part2
  916.     send usenet/news.answers/periodic-postings/part3
  917.     send usenet/news.answers/periodic-postings/part4
  918.     send usenet/news.answers/periodic-postings/part5
  919.     send usenet/news.answers/periodic-postings/part6
  920.     send usenet/news.answers/periodic-postings/part7
  921.     send usenet/news.answers/periodic-postings/part8
  922.  
  923.    If you want to find out more about the mail server, send a message
  924.    to it containing "help".
  925.  
  926. -- 
  927.                 pshuang@mit.edu (Ping Huang)
  928.                 jik@cam.ov.com (Jonathan I. Kamens)
  929.                 ig25@rz.uni-karlsruhe.de (Thomas Koenig)
  930.                 buglady@bronze.lcs.mit.edu (Aliza R. Panitz)
  931.                 pschleck@unomaha.edu (Paul W. Schleck)
  932.  
  933.                         -- the *.answers moderation team
  934.  
  935.